Hermes Agent — Railway Template

Deploy and Host

Deploy Hermes Agent on Railway with a web-based admin dashboard for configuration, gateway management, and user pairing.

Why Deploy

> Hermes Agent is an autonomous AI agent by Nous Research that lives on your server, connects to your messaging channels (Telegram, Discord, Slack, etc.), and gets more capable the longer it runs.

Features

• Admin Dashboard — dark-themed UI to configure providers, channels, tools, and manage the gateway
• One-Page Setup — provider dropdown, checkbox-based channel/tool toggles — no config files to edit
• Gateway Management — start, stop, restart the Hermes gateway from the browser
• Live Status — stat cards for gateway state, uptime, model, and pending pairing requests
• Live Logs — streaming gateway log viewer
• User Pairing — approve or deny users who message your bot, revoke access anytime
• Basic Auth — password-protected admin panel
• Reset Config — one-click reset to start fresh

Getting Started

The easiest way to get started:

1. Get an LLM Provider Key (free)

1. Register for free at OpenRouter
2. Create an API key from your OpenRouter dashboard
3. Pick a free model from the model list sorted by price (e.g. google/gemma-3-1b-it:free, meta-llama/llama-3.1-8b-instruct:free)

2. Set Up a Telegram Bot (fastest channel)

Hermes Agent interacts entirely through messaging channels — there is no chat UI like ChatGPT. Telegram is the quickest to set up:

1. Open Telegram and message @BotFather
2. Send /newbot, follow the prompts, and copy the Bot Token
3. Send a message to your new bot — it will appear as a pairing request in the admin dashboard
4. To find your Telegram user ID, message @userinfobot

3. Deploy to Railway

1. Click the Deploy on Railway button above
2. Set the ADMIN_PASSWORD environment variable (or a random one will be generated and printed to deploy logs)
3. Attach a volume mounted at /data (persists config across redeploys)
4. Open your app URL — log in with username admin and your password

4. Configure in the Admin Dashboard

1. LLM Provider — select OpenRouter from the dropdown, paste your API key, enter the model name
2. Messaging Channel — check Telegram, paste the Bot Token from BotFather
3. Click Save & Start — the gateway will start and your bot goes live

5. Start Chatting

Message your Telegram bot. If you're a new user, a pairing request will appear in the admin dashboard under Users — click Approve, and you're in.

Environment Variables

All other configuration (LLM provider, model, channels, tools) is managed through the admin dashboard.

Supported Providers

OpenRouter, DeepSeek, DashScope, GLM / Z.AI, Kimi, MiniMax, HuggingFace

Supported Channels

Telegram, Discord, Slack, WhatsApp, Email, Mattermost, Matrix

Supported Tool Integrations

Parallel (search), Firecrawl (scraping), Tavily (search), FAL (image gen), Browserbase, GitHub, OpenAI Voice (Whisper/TTS), Honcho (memory)

About Hosting

We recommend Railway as infrastructure provider

Architecture

Railway Container
├── Python Admin Server (Starlette + Uvicorn)
│   ├── /            — Admin dashboard (Basic Auth)
│   ├── /health      — Health check (no auth)
│   └── /api/*       — Config, status, logs, gateway, pairing
└── hermes gateway   — Managed as async subprocess

Deployment Dependencies

The admin server runs on $PORT and manages the Hermes gateway as a child process. Config is stored in /data/.hermes/.env and /data/.hermes/config.yaml. Gateway stdout/stderr is captured into a ring buffer and streamed to the Logs panel.

Running Locally

docker build -t hermes-agent .
docker run --rm -it -p 8080:8080 -e PORT=8080 -e ADMIN_PASSWORD=changeme -v hermes-data:/data hermes-agent

Open http://localhost:8080 and log in with admin / changeme.

Dependencies for

None

Common Use Cases

Research Autonomous Agents, Personal Automations

Credits

• Hermes Agent by Nous Research
• UI inspired by OpenClaw admin template