Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/techjarves/Hermes-USB-Portable/llms.txt

Use this file to discover all available pages before exploring further.

The reset scripts live in the scripts/ subdirectory and provide a safe, interactive way to delete downloaded runtimes (and optionally user data) to trigger a clean reinstall on next launch. Instead of deleting folders by hand, running a reset script ensures the gateway is stopped first and gives you a clear summary of exactly what will be removed before you confirm.

​
Modes

ModeWhat is deletedWhat is kept
soft.cache/runtimes/ and src/hermes-agent/data/ — API keys, config, chat history
fullEverything above plus data/ and .cache/Nothing — completely fresh start

​
Usage

# Run from the project root
cd scripts
.\reset-windows.ps1 -Mode soft
.\reset-windows.ps1 -Mode full

# Interactive (prompts for mode):
.\reset-windows.ps1

​
What Happens

When you run either reset script, it walks through the following steps automatically:
  1. Gateway is stopped — if data/auth.lock exists it is removed, and any running hermes gateway processes are killed so no stale lock files are left behind.
  2. Folders to be deleted are listed with their sizes — you can see exactly how much disk space will be freed before anything is touched.
  3. Preserved data files are listed (soft reset only) — the script explicitly confirms that the following are staying:
    • data/.env — API keys
    • data/config.yaml — settings
    • data/sessions/ — chat history
  4. Confirmation prompt — you must type yes to proceed. Any other input cancels the operation and nothing is deleted.
  5. Deletion and completion report — each folder is removed and confirmed, then a summary message is printed.

​
After Reset

Run the launcher to re-download runtimes and rebuild the source tree:
# macOS / Linux
./launch.sh

rem Windows
launch.bat
Your API keys (data/.env), configuration (data/config.yaml), and chat history (data/sessions/) are all preserved exactly as they were.

​
Arguments Reference

ArgumentPlatformEffect
-Mode softWindowsDelete runtimes and source only; preserve data/
-Mode fullWindowsDelete runtimes, source, and data/
softUnixDelete runtimes and source only; preserve data/
fullUnixDelete runtimes, source, and data/
(no argument)BothInteractive prompt — choose mode at runtime
Full reset is permanent. All sessions, memories, skills, and API keys stored in data/ will be deleted and cannot be recovered. Back up the data/ folder to a safe location before running a full reset if you want to keep any of this data.
The reset script is the recommended way to clean up runtime files rather than deleting folders manually. Running the script first stops the gateway and removes data/auth.lock, which prevents stale lock files that could otherwise cause the gateway to refuse to start on the next launch.
If you just want to update Hermes Agent to the latest version without wiping your data, use a soft reset (or run ./launch.sh hermes update / launch.bat hermes update) instead of a full reset.

Build docs developers (and LLMs) love

Get started for freeTalk to us