Hướng dẫn cài đặt

Chạy Hermes ngay

Hermes Agent v0.8.0 cài trong khoảng 60 giây trên Linux, macOS hoặc WSL2. Một lệnh curl, trình cài đặt lo uv, Python 3.11, Node.js, ripgrep và ffmpeg cho bạn.

checklist Yêu cầu hệ thống

javascript Node.js

Chỉ cần git sẵn — Python 3.11, Node.js v22, uv, ripgrep và ffmpeg do script cài đặt

computer OS

Linux, macOS, WSL2 trên Windows, hoặc Android qua Termux. Windows gốc không được hỗ trợ.

memory RAM

Tối thiểu 2 GB RAM; nhiều hơn nếu chạy model local

hard_drive Disk

~1 GB cho agent, venv, Node modules và skill tích hợp

extension Optional

Tùy chọn: Docker, SSH, Daytona, Singularity hoặc Modal để cô lập lệnh sandbox

wifi Network

Cần kết nối internet cho API model cloud. Model local qua endpoint tương thích OpenAI chạy offline.

Lệnh một dòng từ docs chính thức. Khuyến nghị cho hầu hết người dùng trên Linux, macOS hoặc WSL2. Docs cài đặt arrow_forward

WSL2 (Windows)

Windows gốc không được hỗ trợ. Chạy lệnh này trong WSL2 shell sau 'wsl --install'.

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

macOS / Linux / WSL2

Chỉ cần git sẵn — trình cài đặt lo uv, Python 3.11, Node.js v22, ripgrep và ffmpeg.

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

verified Kiểm tra cài đặt

Chạy các lệnh kiểm tra trong docs chính thức.

1
$ hermes version

In phiên bản đã cài (nên là 0.8.0 trở lên).

2
$ hermes doctor

Chạy kiểm tra chẩn đoán — Python, uv, dependency, file cấu hình và kết nối.

3
$ hermes status

In cấu hình hiện tại: nhà cung cấp model, công cụ đã bật và gateway đã kết nối.

settings Cấu hình ban đầu

Sau khi cài, tải lại shell rồi chạy ba lệnh cấu hình từ docs.

1

Chọn nhà cung cấp model

Chạy 'hermes model' để chọn nhà cung cấp. README liệt kê Nous Portal, OpenRouter, z.ai/GLM, Kimi/Moonshot, MiniMax, OpenAI và endpoint tùy chỉnh. Anthropic và Mistral cũng là dependency.

2

Bật công cụ bạn cần

Chạy 'hermes tools' để cấu hình 47 công cụ tích hợp nào được bật. Thêm bớt sau cũng được.

3

Chạy trình hướng dẫn đầy đủ

Chạy 'hermes setup' để đi qua toàn bộ trình hướng dẫn, bao gồm API key và kết nối gateway chat (Telegram, Discord, Slack, WhatsApp, Signal, Email).

4

Gửi tin nhắn thử

Thử 'hermes chat -q "Hello! What tools do you have available?"' — thẳng từ quickstart chính thức.

.env — Cấu hình nằm trong ~/.hermes/ — config.yaml cho cài đặt chính, .env cho API key, cộng thư mục con cho session, log, memory, skill và cron job. Xem tham chiếu env-vars tại hermes-agent.nousresearch.com/docs/reference/environment-variables.

cloud Triển khai VPS / Server

Hermes chạy trên bất kỳ VPS Linux nào với 2 GB RAM và ~1 GB ổ đĩa. Cùng lệnh một dòng qua SSH.

1

SSH vào server

Bất kỳ bản phân phối Linux nào — Ubuntu, Debian, CentOS, Arch, v.v.

$ ssh user@your-server-ip
2

Chạy trình cài đặt

Script tự nhận diện bản phân phối, cài Python 3.11 qua uv và thiết lập toàn bộ dependency.

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

Bật backend sandbox

Trên hạ tầng chia sẻ, cấu hình một trong các backend sandbox (Docker, SSH, Daytona, Singularity hoặc Modal) để lệnh shell Hermes chạy trong môi trường cô lập. Xem README về cấu hình từng backend.

4

Đặt API key và khởi chạy

Chọn nhà cung cấp model và chạy Hermes. Dùng tmux hoặc screen để duy trì — tiến trình chạy foreground.

$ hermes model && hermes

Tip — Muốn chạy daemon lâu dài, đặt Hermes trong tmux/screen hoặc viết file systemd unit. Xem docs chính thức về cài đặt daemon.

system_update_alt Nâng cấp Hermes

README ghi nhận trình cập nhật tích hợp: 'hermes update'. Không có gói PyPI hay Docker image công khai, nên đường nâng cấp khác đi qua git. Hướng dẫn nâng cấp arrow_forward

npm
$ hermes update
pnpm
$ cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]"
Git
$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Docker
$ # Chưa có Docker image chính thức

Xem github.com/NousResearch/hermes-agent/releases để biết nội dung từng phiên bản.

delete_forever Gỡ cài đặt Hermes

Hermes cài vào ~/.hermes/hermes-agent/ và symlink binary vào ~/.local/bin/hermes. Xóa cả hai chỉ cần hai lệnh. Ghi chú gỡ cài đặt arrow_forward

npm
$ rm ~/.local/bin/hermes
pnpm
$ rm -rf ~/.hermes/hermes-agent
Git (Source)
$ rm -rf ~/.hermes/hermes-agent
Docker
$ # Không có Docker image chính thức để xóa

Xóa dữ liệu người dùng (tùy chọn)

Lệnh này xóa session, memory, skill, cron job và API key. Sao lưu những gì bạn cần trước.

macOS/Linux $ rm -rf ~/.hermes
Windows PS> # Chạy trong WSL shell — Windows gốc không được hỗ trợ

build Xử lý sự cố

Lấy từ bảng xử lý sự cố trong docs cài đặt và các lỗi phổ biến của script cài đặt. Thêm mẹo xử lý sự cố arrow_forward

Cần trợ giúp?

Tham gia Discord Nous Research để được hỗ trợ cài đặt và xử lý sự cố cùng cộng đồng.

forum Tham gia Discord menu_book Docs cài đặt chính thức
hub Tích hợp • article Blog • apps Hệ sinh thái
❯

Cập nhật thường xuyên

Tin tức cộng đồng về bản phát hành, skill mới và tích hợp của Hermes Agent. Không spam, hủy đăng ký bất cứ lúc nào.