Quick Install

Before You Install

System Requirements

A minimal environment check before you run the installer.

Operating System

Supported environments for the current install flow.

macOSLinuxWindows WSL2Termux

Memory

Keep at least 2GB RAM available for a smooth setup and runtime baseline.

2GB+ RAM

Network

Internet access is required to download resources and call your LLM API provider.

Internet RequiredLLM API Access

Dependencies

Leave version placeholders if your stack depends on Python or Node.

Python: <version placeholder>Node: <version placeholder>

# Works on macOS, WSL2, Linux and Termux
$curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# And then start the wizard!
$hermes setup

Installation Quickstart Telegram Setup Migrate from OpenClaw

Zero-Friction Transfer

One-Click Migration

Bring your OpenClaw setup into Hermes with a single command. Hermes imports everything from ~/.openclaw automatically.

$ hermes claw migrate

API KeysMemorySkills

Saves about 10 minutes of manual configuration

Before

Find and copy API credentials by hand
Rebuild memory files and local state
Re-import skills one by one

After

Run hermes claw migrate once
Hermes pulls config from ~/.openclaw
Resume with keys, memory, and skills ready

Gateway Setup

Connect to Your World

Connecting

Use the Hermes gateway to bridge directly into chat surfaces you already live in.

Configure first, then verify the bot is reachable

Gateway Flow

Get Bot Token

Create a bot with BotFather and copy the Bot Token.

Run Setup

Use the official setup wizard first, then start the configured gateway.

hermes gateway setup

Verify Bot Access

Start the gateway and message the bot to verify. If pairing is enabled, approve the code it shows.

hermes gateway

Discord

Configure first, then verify the bot is reachable

Gateway Flow

Get Bot Token

Create an application bot in Discord Developer Portal and copy the Bot Token.

Run Setup

Use the official setup wizard first, then start the configured gateway.

hermes gateway setup

Verify Bot Access

Start the gateway, invite the bot or DM it, and approve pairing only if your setup prompts for one.

hermes gateway

Provider Strategy

Smart Model Selection

Pick the provider profile that matches your deployment goal during hermes setup.

Option	Positioning	Best For	Setup Snippet
Nous Portal Best-fit default	Most aligned Hermes experience	Users who want the smoothest first-run configuration and tuned defaults.	`Provider: Nous Portal Profile: Best-fit default Use case: Turnkey Hermes setup`
OpenRouter Multi-model choice	Flexible provider switchboard	Users comparing multiple hosted models or routing between vendors.	`Provider: OpenRouter Model: anthropic/claude-3.7-sonnet Use case: Multi-model routing`
Local LLM Privacy-first	Runs against your own local endpoint	Users prioritizing privacy, offline control, or self-hosted inference.	`Provider: Local LLM Endpoint: http://localhost:1234/v1 Use case: Private local inference`