🚀 Hermes Go

One command. Your AI, ready.

一行命令，AI 就位。

The simplest way to run Hermes Agent — no terminal skills required.

最简单的 Hermes Agent 启动方式 — 不需要任何终端经验。

---

Run a private AI assistant on your own computer — it remembers everything, runs scheduled tasks while you sleep, and connects to 10+ messaging platforms. No cloud subscription. No data leaves your machine.

在你自己的电脑上运行私有 AI 助手 — 它记住一切、能在你睡觉时执行定时任务、接入 10+ 消息平台。无需云端订阅，数据不离开你的电脑。

✨ What is Hermes Go? / 这是什么？

Hermes Go wraps Hermes Agent with a beautiful browser UI and zero-config installer. Everything you need — from installation to your first AI conversation — happens automatically.

Hermes Go 为 Hermes Agent 提供浏览器图形界面和零配置安装。从安装到第一次 AI 对话，全部自动完成。

vs. hermes-webui: hermes-webui targets developers who want CLI parity in a browser. Hermes Go targets everyone else — people who just want an AI assistant that works out of the box.

🎯 Features / 功能

For Everyone / 人人可用 🔒 Private — your data never leaves your computer 🔧 Zero prerequisites — nothing to install first 🌐 Browser-based setup wizard 💬 Chat with AI in your browser 🔄 Switch models with one click 🌍 English & 中文 interface

Power Features / 进阶功能 📊 Dashboard with usage stats 🧠 Memory management ⚡ Skills & tools browser ⏰ Cron job management 🔀 OpenClaw migration tool

🚀 Quick Start / 快速开始

Prerequisites: None. If you use the git clone method below, you only need git plus bash (already available or easy to install on macOS and Linux).

前置条件：无。 如果你使用下面的 git clone 方式，只需要 git 和 bash（在 macOS 和 Linux 上通常已安装或易于安装）。

git clone https://github.com/LAI-755/hermes-go.git
cd hermes-go
./install.sh
hermes-go

💡 First time? The installer takes 2-5 minutes. It downloads Python, Hermes Agent, and all dependencies automatically. Grab a coffee ☕

💡 第一次安装？ 安装器需要 2-5 分钟，会自动下载 Python、Hermes Agent 和所有依赖。去泡杯咖啡吧 ☕

That's it. The installer automatically handles:

就这样。安装器自动处理：

• ✅ Python — installed via uv if not present
• ✅ Hermes Agent — cloned and installed automatically
• ✅ All dependencies — zero manual configuration
• ✅ Web UI — pre-built, no Node.js needed

🔌 Supported Providers / 支持的模型服务

Provider	Models	Notes
Anthropic	Claude Opus, Sonnet, Haiku	Recommended / 推荐
OpenAI	GPT-4o, GPT-4o-mini, o3
火山引擎 (Volcengine)	豆包 Doubao series	国内推荐
DeepSeek	DeepSeek Chat, Reasoner	国内推荐
OpenRouter	100+ models	Multi-model platform
Custom	Any model	Any OpenAI-compatible API

🖥️ Platform Support / 平台支持

Platform	Status	Notes
macOS	✅ Full support	Intel & Apple Silicon
Linux	✅ Full support	Ubuntu, Debian, Fedora, etc.
Windows	⚠️ Via WSL2	Install WSL2, then follow Linux steps

🏗️ How It Works / 工作原理

Browser → Hermes Go (port 3000) → Hermes Gateway (port 8642)
                ↓
         /api/go/*  → our endpoints (setup, migration, health)
         /api/*     → proxied to Hermes
         /v1/*      → proxied to Hermes
         /*         → web UI static files

Key design: Hermes Go runs as an independent server. It never modifies Hermes Agent code — Hermes upgrades won't break anything.

设计理念：Hermes Go 作为独立服务运行，从不修改 Hermes Agent 代码 — Hermes 升级不会破坏任何功能。

🛠️ For Developers / 开发者指南

The pre-built UI ships with the repo. If you want to modify the frontend:

cd web-ui
pnpm install    # requires Node.js 18+ and pnpm
pnpm dev        # dev server on port 5180
pnpm build      # rebuild dist/

Backend code (Python) can be modified directly — just restart hermes-go.

Project Structure

hermes-go/
├── server.py           # Python HTTP server (port 3000)
├── api/
│   ├── proxy.py        # Reverse proxy → Hermes gateway
│   ├── onboarding.py   # Setup wizard backend
│   ├── migration.py    # OpenClaw migration
│   ├── health.py       # Health checks
│   └── config_writer.py # Config file writer
├── web-ui/
│   ├── src/            # Frontend source (React + TypeScript)
│   └── dist/           # Pre-built (committed to repo)
├── install.sh          # Zero-dep installer
├── hermes-go.sh        # Launcher
└── requirements.txt    # pyyaml only

📝 Environment Variables / 环境变量

Variable	Default	Description
HERMES_PORT	8642	Hermes gateway port
HERMES_GO_PORT	3000	Hermes Go server port
HERMES_HOME	~/.hermes	Hermes config directory
HERMES_AGENT_PATH	auto-detect	Custom Hermes binary path

❓ Troubleshooting / 常见问题

install.sh fails / 安装失败

• Check internet connection (needs to download uv, Python, Hermes)
• On macOS, you may need to allow terminal access in Security settings

hermes-go shows "Hermes not found" / 找不到 Hermes

• Run ./install.sh again
• Or set HERMES_AGENT_PATH to your Hermes installation

Port 3000 or 8642 in use / 端口被占用

• Set HERMES_GO_PORT=3001 hermes-go to use a different port
• Kill existing processes: lsof -ti:3000 | xargs kill

📄 License

MIT

🙏 Credits

• Hermes Agent by Nous Research
• uv by Astral for zero-config Python management

If you find this useful, please ⭐ star this repo — it helps others discover it.