🐚 Hermes Launch

Web onboarding for Hermes Agent. Install, configure, and launch from your browser.

npx hermes-launch

Opens a web wizard at http://localhost:5050 that walks you through everything — no terminal fiddling, no config files, no curl pipes.

What it does

The wizard guides you through 5 steps:

1. Prerequisites — Detects Python, curl, git. Installs missing ones automatically.
2. Install Hermes — Downloads and installs Hermes Agent if not present.
3. Configure model — Pick your LLM provider and model from a dropdown.
4. Enable tools — Toggle which capabilities you want (web search, terminal, file ops, etc.).
5. Start dashboard — Launches the Hermes web dashboard and opens it in your browser.

Everything happens in the browser. The CLI just starts the server and gets out of the way.

Usage

# Start the setup wizard
npx hermes-launch

# Custom port
npx hermes-launch --port 8080

# Stop the background server
npx hermes-launch --stop

# Check if it's running
npx hermes-launch --status

How it works

npx hermes-launch
    │
    ▼
  Starts Node.js HTTP server (port 5050) ──detached──▶ runs forever
    │                                                    │
    ▼                                                    │
  Opens browser to http://localhost:5050                  │
    │                                                    │
    ▼                                                    │
  Web wizard guides through:                              │
    1. Prerequisites check                                │
    2. Hermes install (if needed)                         │
    3. Model/provider selection                           │
    4. Tool enablement                                    │
    5. Dashboard start                                    │
    │                                                    │
    ▼                                                    │
  Done → link to Hermes dashboard at localhost:9119       │
                                                          │
          npx hermes-launch --stop ───────────────────────▶ kills server

• Zero npm dependencies — built-in Node.js http module
• Cross-platform — macOS, Linux, Windows (with auto-install of missing deps)
• Detached server — runs in background after setup, survives terminal close
• No pipe-to-bash — safe for enterprise environments

What's different from v1

| Before (v1) | After (v2) | |---|---| | CLI does everything in terminal | Web wizard does everything in browser | | Tries to open dashboard directly | Opens onboarding page first | | Dashboard dies when script exits | Server is detached, runs forever | | No visual feedback | Step-by-step UI with status | | Manual tool config | Toggle to enable/disable tools | | Browser opening races with server | Waits for server to be ready |

Requirements

• Node.js 18+ (comes with npx)
• Python 3.10+ (auto-installed via winget/choco/brew on some platforms)
• curl, git
• macOS, Linux, or Windows

License

MIT