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.

Hermes Portable ships two reset scripts — one for Windows (reset-windows.ps1) and one for macOS/Linux (reset-unix.sh) — that clean up downloaded artifacts and let the launcher start fresh on the next run. Both scripts support two modes: a soft reset that keeps your personal data intact and a full reset that wipes everything including API keys, sessions, and config. Use a soft reset when runtimes become corrupted or you want to re-download dependencies without losing your setup. Use a full reset only when you want a completely clean slate.

​
Soft Reset vs Full Reset

What gets deletedSoft ResetFull Reset
.cache/runtimes/ (portable Python, Node.js, uv, Git, ripgrep, venv, archives)✅✅
src/hermes-agent/ (Hermes Agent source code)✅✅
.cache/ remainder (any cached data outside runtimes)❌ Preserved✅
data/.env (API keys and credentials)❌ Preserved✅
data/config.yaml (LLM provider settings)❌ Preserved✅
data/sessions/ (chat history)❌ Preserved✅
data/memories/ (persistent memory databases)❌ Preserved✅
data/skills/ (custom learned skills)❌ Preserved✅
Full reset is permanent. All sessions, memories, skills, and API keys are deleted and cannot be recovered. Back up your data/ folder before running a full reset if you want to preserve anything.

​
Running the Reset

Open PowerShell from the project root and run:
cd scripts
.\reset-windows.ps1 -Mode soft
.\reset-windows.ps1 -Mode full

​
Interactive Mode

Running either script without arguments skips directly to an interactive prompt that lets you pick the mode: 
cd scripts
.\reset-windows.ps1
The script will display: 
========================================
   Hermes Portable - Reset
========================================

Choose reset mode:
  [1] Soft reset  - Delete runtimes + source, keep data/ (API keys, config, history)
  [2] Full reset  - Delete everything including data/ (completely fresh start)

Enter 1 or 2:

​
What Happens During a Reset

1

Gateway is stopped

If a background gateway process is running, the script removes data/auth.lock to stop it cleanly, then attempts to kill any running hermes gateway processes before any files are touched.
2

Folders are listed with sizes

Before deleting anything, the script shows each folder that will be removed along with its current size on disk, for example:
The following folders will be DELETED:
  - /media/usb/hermes-portable/.cache/runtimes (812 MB)
  - /media/usb/hermes-portable/src/hermes-agent (98 MB)
On a soft reset you also see a confirmation that data/ will be preserved:
Your data folder is PRESERVED:
  - data/.env        (API keys)
  - data/config.yaml  (settings)
  - data/sessions/    (chat history)
3

Confirmation is required

The script asks you to type yes before it deletes anything. Typing anything else (or pressing Enter) cancels the operation and leaves all files untouched.
Type 'yes' to confirm deletion:
4

Deletion is performed

Each listed folder is removed. Progress is printed for every item. The script exits with a summary when complete.

​
After the Reset

Re-run the launcher to trigger a fresh first-run setup that re-downloads runtimes and the Hermes Agent source:
Double-click launch.bat, or from the project root:
.\launch.bat
After a soft reset, your API keys are still saved in data/.env and your LLM provider configuration is still in data/config.yaml. The launcher will re-download runtimes and source code without asking you to re-enter credentials.After a full reset, the setup wizard will run from scratch and you will need to re-enter all API keys and reconfigure your model providers.

Build docs developers (and LLMs) love

Get started for freeTalk to us