Hermes AI
Install Hermes Agent
Complete guide for Linux, macOS, WSL2, and Windows. Get your AI agent running in 60 seconds.
Quick Install
One command — the installer handles everything:
What the Installer Does
The installer automatically sets up all dependencies:
- ✅ uv — fast Python package manager
- ✅ Python 3.11 — via uv, no sudo
- ✅ Node.js v22 — for browser automation and WhatsApp
- ✅ ripgrep — fast file search
- ✅ ffmpeg — audio conversion for TTS
- ✅ Git repository — cloned and configured
- ✅ Global command
hermes
Note: You don't need to install Python, Node.js, ripgrep, or ffmpeg manually. The installer detects what's missing and installs it automatically. The only prerequisite is Git (git --version). On Linux, make sure you have curl and xz-utils.
After Installation
Reload your shell and run:
Czech language pack
Hermes Agent speaks Czech across the CLI, the terminal UI and the desktop app. Czech ships as a language pack, so switching takes three commands and no reinstall:
Then restart a running gateway with hermes gateway restart. In the desktop app Czech appears in the language picker as Čeština — install the pack where Hermes runs (on the server, for a remote gateway). Hermes WebUI ships Czech out of the box.
Tip: The pack is maintained by the Czech community. If a string stays English after a Hermes update, hermes plugins update hermes-lang-cs pulls the newest catalogs. A handful of strings whose English wording is built from plural counts stay English in the pack — they are translated in the Hermes core.
Configuration
Fastest Path: Nous Portal
One subscription covers 300+ models plus Tool Gateway (web search, image generation, TTS, cloud browser).
System Service Installation
To run Hermes as a dedicated user (e.g., systemd service):
-
Admin: Install Chromium system libraries
$ sudo npx playwright install-deps chromium -
Service user: Install Hermes
$ curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashIf you don't need browser automation:
$ curl -fsSL .../install.sh | bash -s -- --skip-browser -
Make
hermescommand available# Add to PATH $ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc # Or symlink (as admin) $ sudo ln -s /home/hermes/.hermes/hermes-agent/venv/bin/hermes /usr/local/bin/hermes -
Verify
$ hermes doctor
Desktop Installer
On macOS and Windows you can use the Hermes Desktop installer — download from hermes-agent.nousresearch.com and run it. After installation, run hermes desktop.
Manual / Developer Install
For contributors or full control over the virtual environment:
Troubleshooting
| Issue | Solution |
|---|---|
hermes: command not found | Reload shell: source ~/.bashrc |
API key not set | Run hermes model to configure |
| Missing config after update | hermes config check → hermes config migrate |
For more diagnostics: hermes doctor
Minimum Requirements
- 💾 RAM: 1 GB min, 2 GB recommended
- ⚙️ CPU: 1 vCPU minimum
- 💿 Storage: 10–20 GB SSD
- 🐧 OS: Ubuntu 22.04+ or modern Linux
- 🤖 Model: Your own API key — Claude, OpenAI, Gemini, or local
No GPU required — Hermes calls external APIs.
🚀 Need a VPS for Hermes Agent?
Contabo offers the best price/performance ratio. VPS from €5/month with 8 GB RAM — ideal for 24/7 AI agent.
🔥 Get VPS at Contabo →