curl -LsSf https://astral.sh/uv/install.sh | sh

克隆仓库并进入目录

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

使用 Python 3.11 创建虚拟环境

uv venv venv --python 3.11
export VIRTUAL_ENV="$(pwd)/venv"

安装完整依赖

uv pip install -e ".[all]"
uv pip install -e "./tinker-atropos"
npm install  # 可选：浏览器工具和 WhatsApp 桥接需要它

准备配置文件

mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}
cp cli-config.yaml.example ~/.hermes/config.yaml
touch ~/.hermes/.env
echo 'OPENROUTER_API_KEY=sk-or-v1-your-key' >> ~/.hermes/.env

让 hermes 成为全局命令

mkdir -p ~/.local/bin
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes

验证安装

hermes doctor
hermes