Cài đặt

Thiết lập và chạy Hermes Agent trong vòng chưa đầy hai phút bằng trình cài đặt một dòng hoặc làm theo các bước thủ công để có toàn quyền kiểm soát.

Cài đặt nhanh

###Linux / macOS / WSL2

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Windows

Windows gốc không được hỗ trợ. Vui lòng cài đặt WSL2 và chạy Hermes Agent từ đó. Lệnh cài đặt ở trên hoạt động bên trong WSL2.

Trình cài đặt làm gì

Trình cài đặt xử lý mọi thứ một cách tự động — tất cả các phần phụ thuộc (Python, Node.js, ripgrep, ffmpeg), bản sao kho lưu trữ, môi trường ảo, thiết lập lệnh hermes toàn cầu và cấu hình nhà cung cấp LLM. Cuối cùng, bạn đã sẵn sàng trò chuyện.

Sau khi cài đặt

Tải lại shell của bạn và bắt đầu trò chuyện:

source ~/.bashrc   # or: source ~/.zshrc
hermes             # Start chatting!

Để cấu hình lại các cài đặt riêng lẻ sau này, hãy sử dụng các lệnh chuyên dụng:

hermes model          # Choose your LLM provider and model
hermes tools          # Configure which tools are enabled
hermes gateway setup  # Set up messaging platforms
hermes config set     # Set individual config values
hermes setup          # Or run the full setup wizard to configure everything at once

Điều kiện tiên quyết

Điều kiện tiên quyết duy nhất là Git. Trình cài đặt tự động xử lý mọi thứ khác:

uv (trình quản lý gói Python nhanh)
Python 3.11 (thông qua uv, không cần sudo)
Node.js v22 (dành cho tự động hóa trình duyệt và cầu nối WhatsApp)
ripgrep (tìm kiếm tập tin nhanh)
ffmpeg (chuyển đổi định dạng âm thanh cho TTS)

thông tin

Bạn không cần cài đặt Python, Node.js, ripgrep hoặc ffmpeg theo cách thủ công. Trình cài đặt sẽ phát hiện những gì còn thiếu và cài đặt nó cho bạn. Chỉ cần đảm bảo git có sẵn (git --version).

Nix users

Nếu bạn sử dụng Nix (trên NixOS, macOS hoặc Linux), sẽ có đường dẫn thiết lập chuyên dụng với phần mềm Nix, mô-đun NixOS khai báo và chế độ vùng chứa tùy chọn. Xem hướng dẫn Thiết lập Nix & NixOS.

Cài đặt thủ công

Nếu bạn muốn có toàn quyền kiểm soát quá trình cài đặt, hãy làm theo các bước sau.

Bước 1: Sao chép kho lưu trữ

Sao chép với --recurse-submodules để kéo các mô-đun con cần thiết:

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

Nếu bạn đã nhân bản mà không có --recurse-submodules:

git submodule update --init --recursive

Bước 2: Cài đặt uv & Tạo môi trường ảo

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create venv with Python 3.11 (uv downloads it if not present — no sudo needed)
uv venv venv --python 3.11

mẹo

Bạn không cần kích hoạt venv để sử dụng hermes. Điểm vào có một shebang được mã hóa cứng trỏ đến venv Python, vì vậy nó hoạt động trên toàn cầu sau khi được liên kết tượng trưng.

Bước 3: Cài đặt Python Dependency

# Tell uv which venv to install into
export VIRTUAL_ENV="$(pwd)/venv"

# Install with all extras
uv pip install -e ".[all]"

Nếu bạn chỉ muốn tác nhân cốt lõi (không hỗ trợ Telegram/Discord/cron):

uv pip install -e "."

Optional extras breakdown

Thêm	Nó bổ sung thêm những gì	Lệnh cài đặt
`tất cả`	Mọi thứ bên dưới	`uv pip cài đặt -e ".[all]"`
`nhắn tin`	Cổng Telegram & Discord	`uv pip cài đặt -e ".[nhắn tin]"`
`cron`	Phân tích biểu thức cron cho các tác vụ theo lịch trình	`uv pip cài đặt -e ".[cron]"`
`cli`	Giao diện người dùng menu đầu cuối cho trình hướng dẫn thiết lập	`uv pip cài đặt -e ".[cli]"`
`phương thức`	Chương trình phụ trợ thực thi đám mây phương thức	`uv pip cài đặt -e ".[modal]"`
`tts-cao cấp`	Giọng nói cao cấp của ElevenLabs	`uv pip cài đặt -e ".[tts-premium]"`
`giọng nói`	Đầu vào micrô CLI + phát lại âm thanh	`uv pip cài đặt -e ".[voice]"`
`pty`	Hỗ trợ thiết bị đầu cuối PTY	`uv pip cài đặt -e ".[pty]"`
`honcho`	Bộ nhớ gốc AI (tích hợp Honcho)	`uv pip cài đặt -e ".[honcho]"`
`mcp`	Hỗ trợ giao thức bối cảnh mô hình	`uv pip cài đặt -e ".[mcp]"`
`trợ lý gia đình`	Tích hợp Trợ lý Trang chủ	`uv pip install -e ".[homeassistant]"`
`acp`	Hỗ trợ tích hợp trình soạn thảo ACP	`uv pip cài đặt -e ".[acp]"`
`lười biếng`	Nhắn tin chậm chạp	`uv pip cài đặt -e ".[slack]"`
`dev`	tiện ích pytest & kiểm tra	`uv pip cài đặt -e ".[dev]"`

Bạn có thể kết hợp các tính năng bổ sung: uv pip install -e ".[messaging,cron]"

Bước 4: Cài đặt các Submodule tùy chọn (nếu cần)

# RL training backend (optional)
uv pip install -e "./tinker-atropos"

Cả hai đều là tùy chọn — nếu bạn bỏ qua chúng, bộ công cụ tương ứng sẽ không có sẵn.

Bước 5: Cài đặt phụ thuộc Node.js (Tùy chọn)

Chỉ cần thiết cho tự động hóa trình duyệt (được hỗ trợ bởi cơ sở trình duyệt) và cầu nối WhatsApp:

npm install

Bước 6: Tạo thư mục cấu hình

# Create the directory structure
mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}

# Copy the example config file
cp cli-config.yaml.example ~/.hermes/config.yaml

# Create an empty .env file for API keys
touch ~/.hermes/.env

Bước 7: Thêm khóa API của bạn

Mở ~/.hermes/.env và thêm ít nhất một khóa nhà cung cấp LLM:

# Required — at least one LLM provider:
OPENROUTER_API_KEY=sk-or-v1-your-key-here

# Optional — enable additional tools:
FIRECRAWL_API_KEY=fc-your-key          # Web search & scraping (or self-host, see docs)
FAL_KEY=your-fal-key                   # Image generation (FLUX)

Hoặc đặt chúng thông qua CLI:

hermes config set OPENROUTER_API_KEY sk-or-v1-your-key-here

Bước 8: Thêm `hermes` vào PATH của bạn

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

Nếu ~/.local/bin không có trên PATH của bạn, hãy thêm nó vào cấu hình shell của bạn:

# Bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

# Zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

# Fish
fish_add_path $HOME/.local/bin

Bước 9: Định cấu hình nhà cung cấp của bạn

hermes model       # Select your LLM provider and model

Bước 10: Xác minh cài đặt

hermes version    # Check that the command is available
hermes doctor     # Run diagnostics to verify everything is working
hermes status     # Check your configuration
hermes chat -q "Hello! What tools do you have available?"

Tham khảo nhanh: Cài đặt thủ công (Thu gọn)

Đối với những người chỉ muốn các lệnh:

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

# Clone & enter
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Create venv with Python 3.11
uv venv venv --python 3.11
export VIRTUAL_ENV="$(pwd)/venv"

# Install everything
uv pip install -e ".[all]"
uv pip install -e "./tinker-atropos"
npm install  # optional, for browser tools and WhatsApp

# Configure
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

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

# Verify
hermes doctor
hermes

Khắc phục sự cố

Vấn đề	Giải pháp
`hermes: không tìm thấy lệnh`	Tải lại shell của bạn (`source ~/.bashrc`) hoặc kiểm tra PATH
`Khóa API chưa được đặt`	Chạy `hermes model` để định cấu hình nhà cung cấp của bạn hoặc `hermes config set OPENROUTER_API_KEY your_key`
Thiếu cấu hình sau khi cập nhật	Chạy `kiểm tra cấu hình hermes` rồi `di chuyển cấu hình hermes`

Để biết thêm chẩn đoán, hãy chạy hermes doctor — nó sẽ cho bạn biết chính xác những gì còn thiếu và cách khắc phục.

Cài đặt nhanh​

Trình cài đặt làm gì​

Sau khi cài đặt​

Điều kiện tiên quyết​

Cài đặt thủ công​

Bước 1: Sao chép kho lưu trữ​

Bước 2: Cài đặt uv & Tạo môi trường ảo​

Bước 3: Cài đặt Python Dependency​

Bước 4: Cài đặt các Submodule tùy chọn (nếu cần)​

Bước 5: Cài đặt phụ thuộc Node.js (Tùy chọn)​

Bước 6: Tạo thư mục cấu hình​

Bước 7: Thêm khóa API của bạn​

Bước 8: Thêm hermes vào PATH của bạn​

Bước 9: Định cấu hình nhà cung cấp của bạn​

Bước 10: Xác minh cài đặt​

Tham khảo nhanh: Cài đặt thủ công (Thu gọn)​

Khắc phục sự cố​