Uninstall Hermes-agent

Published on

•

Uninstall Hermes-agent
Do not index
To uninstall hermes-agent, stop the gateway with hermes gateway stop, run hermes uninstall, and choose soft (keep ~/.hermes/ config) or full (remove everything), then verify by listing ~/.hermes/, ~/.local/bin/hermes, and any service entries. If you are uninstalling because the agent keeps dying when your laptop sleeps, we recommend Agent 37 instead: managed Hermes hosting from $3.99 per month in an isolated container, where removal means deleting the instance. Agent 37 is not the Hermes uninstaller and does not touch your local machine; it is the hosted place to run Hermes so you never have to install it locally.
Key takeaways
  • hermes uninstall is the official path: it prompts for a soft uninstall (keeps ~/.hermes/ config, sessions, and keys) or a full uninstall (deletes the data directory too), then removes the source clone, launcher, and PATH entries.
  • Stop before you delete: run hermes gateway stop, then confirm nothing is left with ps aux | grep hermes on Linux and macOS or Get-Process | Where-Object ProcessName -like "*hermes*" on Windows, or locked files will survive the wipe.
  • Windows full mode can leave files behind: a public GitHub issue against the project reports that hermes uninstall does not finish on Windows, so always check dir $env:USERPROFILE\.hermes afterwards and remove leftovers by hand.
  • Ollama models are not removed: Hermes never deletes ~/.ollama/models; run ollama list and ollama rm <model> yourself if you want the disk space back.
  • Agent 37 is the alternative to local installs: Hermes runs in an isolated container from $3.99 per month, your API keys go directly to Anthropic or OpenAI, and there is nothing to uninstall from your laptop.
notion image

What is the quickest command to uninstall Hermes Agent?

The quickest way is to run hermes uninstall in a terminal. It asks two questions: whether to keep your ~/.hermes/ configuration and sessions (soft uninstall) or remove everything (full uninstall), and whether to proceed. It then stops the gateway, deletes the source directory, the launcher, and PATH entries, and prints what it removed.
The soft option is the right default if you plan to reinstall later or move to a hosted instance and want to carry your config.yaml, .env, skills, and memory across. The full option is for selling the machine, handing it to someone else, or fixing a broken install where you want a clean slate.
One decision rule: if you are uninstalling because of a bug rather than because you are done with Hermes, pick soft, reinstall with the official script from the NousResearch/hermes-agent repository, and only escalate to full if the problem survives the reinstall. Most "broken" installs are a stale venv or a half-finished update, not corrupted config.

How do you stop the Hermes gateway before uninstalling?

Run hermes gateway stop first, then hermes gateway status to confirm it reports stopped. If you installed the gateway as a background service, also remove the service entry so it does not restart on login. Finally, check for stray processes with ps aux | grep hermes or the PowerShell equivalent, and kill anything still running before you delete files.
The gateway is the long-running process that connects Hermes to Telegram, Discord, Slack, WhatsApp, and the other messaging surfaces. On Linux it is normally a user-level systemd unit, on macOS a launchd agent, and on Windows a scheduled task or startup entry. hermes gateway stop handles the running process; whether the service definition is removed depends on which uninstall mode you pick, so verify it yourself.
A process you forgot about is the single most common reason a wipe fails. On Linux, systemctl --user list-units | grep -i hermes shows any surviving unit. On macOS, launchctl list | grep -i hermes does the same. On Windows, open Task Manager and check both the Processes and Startup tabs, then run Get-ScheduledTask | Where-Object TaskName -like "*hermes*" in PowerShell.

What does hermes uninstall remove, and what does it leave behind?

A full uninstall removes the ~/.hermes/ data directory, the source clone and its virtual environment, the hermes launcher in ~/.local/bin, any lines the installer added to your shell profile, and the gateway service entry. A soft uninstall removes all of those except ~/.hermes/. Neither mode removes Ollama, cached models, Node.js, uv, or Python.
Use this checklist to verify a clean wipe. Each line is a path or entry the installer can create; if it still exists after uninstalling, delete it manually.
  • ~/.hermes/ (config.yaml, .env, state database, skills, memories, logs)
  • The source clone the installer created, usually inside ~/.hermes/ on a script install, and the venv inside it
  • ~/.local/bin/hermes and any PATH export the installer appended to ~/.bashrc, ~/.zshrc, or ~/.profile
  • A systemd user unit on Linux, a plist in ~/Library/LaunchAgents/ on macOS, or a scheduled task and Startup folder entry on Windows
  • Hermes Desktop itself, which is a separate application and is not removed by the CLI command
The installer type changes the first two entries. A pip or pipx install has no source clone, so pipx uninstall hermes-agent or pip uninstall hermes-agent replaces that step, while ~/.hermes/ still has to be removed by hand. A git clone you ran yourself lives wherever you put it, and hermes uninstall will not know about a second copy. Which paths hold secrets matters too: ~/.hermes/.env is where API keys live, which is the same exposure problem we cover in our guide to how coding agents read your repo and what else they can reach.
notion image

How do you uninstall Hermes Agent on Linux or Ubuntu?

On Linux, run hermes gateway stop, then hermes uninstall and pick your mode. Afterwards, check systemctl --user list-units --all | grep -i hermes for a leftover unit, run systemctl --user disable and daemon-reload if one remains, delete ~/.hermes/ for a full wipe, and remove the PATH line from your shell profile.
Ubuntu users who installed through the one-line script will find both the data and the source clone under their home directory, so a single rm -rf ~/.hermes finishes the job once the service is gone. Open a new terminal afterwards: if hermes still resolves, the launcher or PATH export is still present, and which hermes tells you where.
If the hermes command is not found before you even start, the launcher is already gone but the data probably is not. Skip the CLI and go straight to the manual steps: stop any process, remove the systemd unit from ~/.config/systemd/user/, then delete ~/.hermes/. If you want a copy of your config first, archive config.yaml, .env, and the skills folder before deleting.

How do you remove Hermes Agent and Hermes Desktop on macOS?

On macOS, stop the gateway, run hermes uninstall, and then clear what the CLI does not own: drag Hermes Desktop out of /Applications, remove any plist matching hermes from ~/Library/LaunchAgents/, and delete leftover folders in ~/Library/Application Support/ and ~/Library/Caches/. Hermes Desktop also offers removal from Settings &gt; About &gt; Danger zone.
The Danger zone screen in Hermes Desktop gives two choices. One removes only the chat GUI and leaves the agent and its data in place, which is what you want if you prefer the terminal. The other removes the GUI and the agent together, which is the full-wipe path for people who installed Hermes only through the desktop app.
Two macOS specifics catch people. First, launchctl will keep relaunching a gateway until you both unload the plist and delete the file, so do launchctl bootout gui/$(id -u)/<label> before removing it. Second, deleting an app bundle from Applications never clears ~/Library, which Apple documents in its support material at support.apple.com, so the Library sweep is a required step rather than an optional one.

Why does hermes uninstall leave files behind on Windows 10 and 11, and how do you finish the job?

A GitHub issue filed against the project reports that full-mode hermes uninstall can exit without deleting the .hermes folder on Windows, usually because a running process or an open log file holds a lock. Verify with dir $env:USERPROFILE\.hermes, stop every hermes process, then remove the folder with Remove-Item -Recurse -Force.
The PowerShell sequence looks like this. Run hermes gateway stop, then Get-Process | Where-Object ProcessName -like "*hermes*" | Stop-Process -Force. Then run hermes uninstall and pick full. When it finishes, run Remove-Item -Recurse -Force "$env:USERPROFILE\.hermes" and confirm the folder is gone with Test-Path.
Access denied errors mean a file is locked or owned by another account. Close Hermes Desktop, close any terminal that has hermes open, and if the error persists, open PowerShell as administrator and run takeown /F "$env:USERPROFILE\.hermes" /R before retrying. Also check shell:startup, Task Scheduler, and HKCU\Software\Microsoft\Windows\CurrentVersion\Run for a gateway entry, and remove the Hermes Desktop entry from Settings &gt; Apps &gt; Installed apps, which Microsoft walks through at support.microsoft.com. If you originally installed Hermes inside WSL2, none of this applies: open the Ubuntu distro and follow the Linux steps instead.

Should you delete Ollama models and other dependencies Hermes installed?

Only if you are not using them for anything else. Hermes does not remove Ollama, the models it pulled, Node.js, uv, or Python on any operating system. Run ollama list to see what is on disk, ollama rm <model> to delete individual models, and remove ~/.ollama (or %USERPROFILE%\.ollama on Windows) only if you are finished with Ollama entirely.
Models are where the disk space actually is. A single local model can be several gigabytes, so a Hermes install that looks tiny in ~/.hermes/ can be hiding tens of gigabytes under ~/.ollama/models. The Ollama project documents model storage locations in its GitHub repository, and du -sh ~/.ollama tells you what you would reclaim.
Treat API keys with the same care as model files. If you are handing the machine over, wiping ~/.hermes/.env is not enough on its own; rotate the keys at Anthropic, OpenAI, or whichever provider issued them. NIST Special Publication 800-88 is the standard reference for media sanitization, and its central point applies here: deleting a file removes the pointer, not necessarily the data.
notion image

Is there a way to factory reset Hermes Agent without uninstalling it?

Yes. Stop the gateway, back up ~/.hermes/config.yaml and ~/.hermes/.env if you want to keep your settings and keys, delete the rest of ~/.hermes/ (sessions, memory, skills, logs), then run hermes setup to rebuild the data directory. The source clone, venv, and launcher stay in place, so no reinstall is needed.
This is the right move when the agent has accumulated bad memories or a corrupted session database but the install itself is fine. A soft hermes uninstall followed by a fresh install reaches the same end state with more steps, so prefer the reset.
After either a reset or a full wipe, reinstalling is the same one-line script you used the first time. If you kept config.yaml and .env, copy them back into ~/.hermes/ before running hermes setup, and the wizard will pick up your provider, model, and messaging settings instead of asking again.

When does hosting Hermes on Agent 37 remove the need to uninstall at all?

If you are uninstalling because Hermes stops answering when your laptop sleeps, or because you do not want API keys and sessions on a personal machine, run it somewhere else. Agent 37 hosts Hermes in an isolated container from $3.99 per month, so removal is deleting the instance rather than hunting through your home directory.
The practical differences are the ones this guide has been fighting. On a laptop, Hermes writes config, keys, sessions, and a source clone into your user profile, and a gateway service has to be tracked across systemd, launchd, or the Windows registry. On managed Hermes hosting, the whole stack lives in one container, your API keys go directly to Anthropic or OpenAI, and a browser terminal, file browser, and live Linux desktop let you inspect that container without touching your own machine.
It also changes what a recurring job looks like. Instead of a cron entry on a machine that may be asleep, the built-in task board assigns work, reviews outputs, and schedules repeat runs, which we cover in detail in our guide on how to schedule AI agents on a timer. Agencies get the same isolation per client, which is why the always-on AI agent hosting plans are built around one container per agent rather than one shared server. Agent 37 reached #1 Product of the Day on Product Hunt, and the bring-your-own-keys model means the company never holds your provider credentials.

How did we put this guide together?

We worked from the official Hermes Agent documentation for hermes uninstall and hermes gateway, the public GitHub issue tracker for the Windows uninstall report, and the standard locations each operating system uses for user services and application data. Agent 37 details come from its published solution and pricing pages.

How do you get started with Agent 37?

If you would rather never run this uninstall checklist again, deploy a managed Hermes instance on Agent 37 from $3.99 per month: one click starts the full agent stack in an isolated container, your API keys go straight to the provider, and the task board handles recurring jobs.

What do people also ask?

How do I stop the Hermes agent from running?
Run hermes gateway stop, then hermes gateway status to confirm it reports stopped. If a service relaunches it, disable the systemd user unit on Linux, bootout the launchd plist on macOS, or remove the scheduled task and Startup entry on Windows, then kill any remaining process with ps aux | grep hermes or Stop-Process.
How do I uninstall an agent like Hermes completely?
Stop its background service, run the project's own uninstaller (hermes uninstall in full mode), then verify by listing the data directory, the launcher path, shell profile PATH lines, and service entries. Anything still present after the uninstaller finishes should be deleted by hand, and provider API keys should be rotated.
How do I remove Hermes Desktop?
Open Hermes Desktop, go to Settings &gt; About &gt; Danger zone, and choose either GUI-only removal (keeps the agent and data) or full removal (removes the agent too). On macOS, also drag the app out of Applications and clear hermes entries from \~/Library/LaunchAgents, Application Support, and Caches. On Windows, remove it from Settings &gt; Apps.
How do I factory reset Hermes Agent without uninstalling it?
Stop the gateway, back up \~/.hermes/config.yaml and \~/.hermes/.env if you want to keep settings and keys, delete the rest of \~/.hermes/ (sessions, memory, skills, logs), and run hermes setup. The source clone, venv, and launcher stay in place, so there is no reinstall.
Does hermes uninstall delete my config, sessions, and API keys?
Only in full mode. The soft uninstall keeps \~/.hermes/, which holds config.yaml, the .env file with your API keys, the session database, and memories. Full mode deletes that directory. Neither mode removes Ollama models under \~/.ollama, and neither rotates keys at Anthropic or OpenAI, so do that separately if you are handing the machine over.