Hermes-Installer

Terminal wrapper for Nous Research Hermes Agent installer

hermes-installer downloads and runs the Hermes Agent bash installer directly in your terminal with full PTY support. Arrow keys, interactive prompts, and selections work natively.

Features

• Native Terminal PTY: Runs directly in your terminal — no web interface needed
• Full Interactive Support: Arrow keys, dropdowns, checkboxes, password prompts all work
• Cross-Platform: Works on Windows (WSL/Git Bash), Linux, and macOS
• Auto-Download: Automatically downloads the latest Hermes installer from GitHub
• Minimal Dependencies: Only requires requests

Installation

pip install hermes-installer

Usage

# Run the installer
hermes-installer

# Or
python -m hermes_installer

The installer will:

1. Download Hermes installer from GitHub (cached for 1 hour)
2. Launch it in your terminal with full interactive support
3. Run the complete Hermes setup with all prompts

After installation, you can:

source ~/.bashrc  # reload shell (or: source ~/.zshrc)
hermes            # start chatting!

Platform-Specific Notes

Linux & macOS

Hermes installs to ~/.local/bin/hermes by default.

Running Hermes:

# The installer should add hermes to your PATH
# You may need to restart your terminal or run:
source ~/.bashrc  # or ~/.zshrc for zsh

# Then use hermes
hermes

If hermes command not found:

# Add to PATH manually (add to your ~/.bashrc or ~/.zshrc)
export PATH="$HOME/.local/bin:$PATH"

# Or run with full path
~/.local/bin/hermes

Windows

On Windows, Hermes is installed inside the Linux environment (WSL) or Git Bash, not in Windows itself.

Bash Selection Priority

1. WSL2 (preferred) - if wsl --version succeeds
2. Git Bash (fallback) - if found in standard locations

Running Hermes from Windows

From PowerShell/CMD:

# Use 'wsl' prefix to access the Linux-installed command
wsl hermes

From WSL terminal:

# Enter WSL first
wsl

# Then run directly
hermes

Hermes Commands

After installation, Hermes provides these commands:

Command	Description
hermes	Interactive CLI — start a conversation
hermes model	Choose your LLM provider and model
hermes tools	Configure which tools are enabled
hermes config set <key> <value>	Set individual config values
hermes gateway	Start the messaging gateway (Telegram, Discord, etc.)
hermes setup	Run the full setup wizard
hermes update	Update to the latest version
hermes doctor	Diagnose any issues

Requirements

• Python: 3.8+
• Windows: WSL2 or Git Bash
• Linux: Any distribution with bash
• macOS: 10.14+ with bash or zsh
• Git: Required by the Hermes installer

How It Works

┌─────────────┐     exec/spawn     ┌─────────────┐
│   Terminal  │ ◄────────────────► │   Hermes    │
│   (Your     │      Full PTY      │   Installer │
│   Shell)    │                    │             │
└─────────────┘                    └─────────────┘

The wrapper:

1. Downloads install.sh from the NousResearch/hermes-agent GitHub repo
2. Detects the best available shell:
   • Linux/macOS: Native bash/zsh
   • Windows: WSL → Git Bash
3. Executes the installer with your terminal's stdin/stdout
4. Full PTY support ensures interactive prompts work

Development

# Clone repository
git clone https://github.com/nousresearch/hermes-agent.git
cd hermes-installer

# Install in editable mode
pip install -e .

# Run
python -m hermes_installer

License

Apache 2.0 - See LICENSE file

---

Built by Nous Research. See the Hermes Agent documentation for more information.