Bắt đầu nhanh

Hướng dẫn này sẽ hướng dẫn bạn cách cài đặt Hermes Agent, thiết lập nhà cung cấp và thực hiện cuộc trò chuyện đầu tiên. Cuối cùng, bạn sẽ biết các tính năng chính và cách khám phá thêm.

1. Cài đặt Hermes Agent

Chạy trình cài đặt một dòng:

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

Người dùng Windows

Trước tiên hãy cài đặt WSL2, sau đó chạy lệnh trên trong terminal WSL2 của bạn.

Sau khi hoàn tất, hãy tải lại shell của bạn:

source ~/.bashrc   

# or source ~/.zshrc

2. Thiết lập nhà cung cấp

Trình cài đặt sẽ tự động cấu hình nhà cung cấp LLM của bạn. Để thay đổi nó sau này, hãy sử dụng một trong các lệnh sau:

hermes model       

# Choose your LLM provider and model
hermes tools       

# Configure which tools are enabled
hermes setup       

# Or configure everything at once

hermes model hướng dẫn bạn cách chọn nhà cung cấp suy luận:

Nhà cung cấp	Mô tả	Cách thiết lập
Nous Portal	Dựa trên đăng ký, không cần cấu hình	Đăng nhập OAuth qua `hermes model`
OpenAI Codex	ChatGPT OAuth, sử dụng mô hình Codex	Xác thực mã thiết bị qua `hermes model`
Anthropic	Mô hình Claude trực tiếp (khóa Pro/Max hoặc API)	`hermes model` bằng mã xác thực Claude Code hoặc khóa API Anthropic
OpenRouter	Định tuyến nhiều nhà cung cấp trên nhiều mô hình	Nhập khóa API của bạn
Z.AI	Các mô hình GLM / Zhipu	Đặt `GLM_API_KEY` / `ZAI_API_KEY`
Kimi / Moonshot	Các mô hình trò chuyện và coding trên Moonshot	Đặt `KIMI_API_KEY`
MiniMax	Endpoint MiniMax quốc tế	Đặt `MINIMAX_API_KEY`
MiniMax China	Endpoint MiniMax khu vực Trung Quốc	Đặt `MINIMAX_CN_API_KEY`
Alibaba Cloud	Mô hình Qwen qua DashScope	Đặt `DASHSCOPE_API_KEY`
Hugging Face	Hơn 20 mô hình mở thông qua unified router (Qwen, DeepSeek, Kimi, v.v.)	Đặt `HF_TOKEN`
KiloCode	Các mô hình trên KiloCode	Đặt `KILOCODE_API_KEY`
OpenCode Zen	Truy cập pay-as-you-go vào các mô hình được quản lý	Đặt `OPENCODE_ZEN_API_KEY`
OpenCode Go	Đăng ký $10/tháng cho các mô hình mở	Đặt `OPENCODE_GO_API_KEY`
DeepSeek	Truy cập API DeepSeek trực tiếp	Đặt `DEEPSEEK_API_KEY`
GitHub Copilot	Đăng ký GitHub Copilot (GPT-5.x, Claude, Gemini, v.v.)	OAuth qua `hermes model` hoặc `COPILOT_GITHUB_TOKEN` / `GH_TOKEN`
GitHub Copilot ACP	Backend của agent Copilot ACP (chạy `copilot` CLI cục bộ)	`hermes model` (yêu cầu `copilot` CLI + `copilot login`)
Vercel AI Gateway	Định tuyến qua Vercel AI Gateway	Đặt `AI_GATEWAY_API_KEY`
Custom Endpoint	VLLM, SGLang, Ollama hoặc bất kỳ API tương thích OpenAI nào	Đặt URL cơ sở + khóa API

mẹo

Bạn có thể chuyển đổi nhà cung cấp bất kỳ lúc nào bằng hermes model — không cần thay đổi mã, không cần khóa. Khi định cấu hình điểm cuối tùy chỉnh, Hermes sẽ nhắc kích thước cửa sổ ngữ cảnh và tự động phát hiện nó khi có thể. Xem Phát hiện độ dài ngữ cảnh để biết chi tiết.

3. Bắt đầu trò chuyện

hermes

Thế thôi! Bạn sẽ thấy biểu ngữ chào mừng có mô hình, công cụ có sẵn và kỹ năng của bạn. Nhập tin nhắn và nhấn Enter.

❯ What can you help me with?

Tác nhân có quyền truy cập vào các công cụ để tìm kiếm trên web, thao tác tệp, lệnh đầu cuối, v.v. — tất cả đều có sẵn.

4. Dùng thử các tính năng chính

Yêu cầu nó sử dụng terminal

❯ What's my disk usage? Show the top 5 largest directories.

```Tác nhân sẽ thay mặt bạn chạy các lệnh đầu cuối và hiển thị kết quả cho bạn.

#

## Sử dụng lệnh gạch chéo

Nhập `/` để xem danh sách thả xuống tự động hoàn thành của tất cả các lệnh:

| Lệnh | Nó làm gì |
|----------|-------------|
|  `/help` | Hiển thị tất cả các lệnh có sẵn |
|  `/tools` | Liệt kê các công cụ có sẵn |
|  `/model` | Chuyển đổi mô hình tương tác |
|  `/personality pirate` | Hãy thử tính cách vui vẻ |
|  `/save` | Lưu cuộc trò chuyện |

#

## Nhập nhiều dòng

Nhấn `Alt+Enter` hoặc `Ctrl+J` để thêm dòng mới. Tuyệt vời để dán mã hoặc viết lời nhắc chi tiết.

#

## Ngắt đại lý

Nếu tác nhân mất quá nhiều thời gian, chỉ cần nhập tin nhắn mới và nhấn Enter — thao tác này sẽ làm gián đoạn tác vụ hiện tại và chuyển sang hướng dẫn mới của bạn.  `Ctrl+C` cũng hoạt động.

#

## Tiếp tục một phiên

Khi bạn thoát, Hermes in lệnh tiếp tục:

```bash
hermes --continue    

# Resume the most recent session
hermes -c            

# Short form

5. Khám phá thêm

Dưới đây là một số điều cần thử tiếp theo:

Thiết lập terminal có hộp cát

Để an toàn, hãy chạy tác nhân trong vùng chứa Docker hoặc trên máy chủ từ xa:

hermes config set terminal.backend docker    

# Docker isolation
hermes config set terminal.backend ssh       

# Remote server

Kết nối nền tảng nhắn tin

Trò chuyện với Hermes từ điện thoại của bạn hoặc các nền tảng khác thông qua Telegram, Discord, Slack, WhatsApp, Signal, Email hoặc Home Assistant:

hermes gateway setup    

# Interactive platform configuration

Thêm chế độ giọng nói

Bạn muốn đầu vào micrô trong CLI hoặc trả lời bằng giọng nói trong tin nhắn?

pip install "hermes-agent[voice]"

# Optional but recommended for free local speech-to-text
pip install faster-whisper

Sau đó khởi động Hermes và kích hoạt nó trong CLI:

/voice on

Nhấn Ctrl+B để ghi âm hoặc sử dụng /voice tts để Hermes phát biểu câu trả lời của mình. Xem Chế độ giọng nói để biết cách thiết lập đầy đủ trên các kênh thoại CLI, Telegram, Discord và Discord.

Lên lịch các tác vụ tự động

❯ Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.

Tác nhân sẽ thiết lập một công việc định kỳ chạy tự động qua cổng.

Kỹ năng duyệt và cài đặt

hermes skills search kubernetes
hermes skills search react --source skills-sh
hermes skills search https://mintlify.com/docs --source well-known
hermes skills install openai/skills/k8s
hermes skills install official/security/1password
hermes skills install skills-sh/vercel-labs/json-render/json-render-react --force

Lời khuyên:

Sử dụng --source skills-sh để tìm kiếm thư mục skills.sh công khai.
Sử dụng --source well-known với URL tài liệu/trang web để khám phá các kỹ năng từ /.well-known/skills/index.json .
Chỉ sử dụng --force sau khi xem xét kỹ năng của bên thứ ba. Nó có thể ghi đè các khối chính sách không nguy hiểm nhưng không thể ghi đè kết quả quét dangerous.

Hoặc sử dụng lệnh gạch chéo /skills trong cuộc trò chuyện.

Sử dụng Hermes bên trong trình soạn thảo thông qua ACP

Hermes cũng có thể chạy như một máy chủ ACP cho các trình soạn thảo tương thích với ACP như VS Code, Zed và JetBrains:

pip install -e '.[acp]'
hermes acp

Xem Tích hợp ACP Editor để biết chi tiết thiết lập.

Dùng thử máy chủ MCP

Kết nối với các công cụ bên ngoài thông qua Model Context Protocol:

# Add to ~/.hermes/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Tham khảo nhanh

Lệnh	Mô tả
`hermes`	Bắt đầu trò chuyện
`hermes model`	Chọn nhà cung cấp và mô hình LLM của bạn
`hermes tools`	Định cấu hình công cụ nào được bật trên mỗi nền tảng
`hermes setup`	Trình hướng dẫn thiết lập đầy đủ (cấu hình mọi thứ cùng một lúc)
`hermes doctor`	Chẩn đoán sự cố
`hermes update`	Cập nhật lên phiên bản mới nhất
`hermes gateway`	Bắt đầu cổng nhắn tin
`hermes --continue`	Tiếp tục phiên cuối cùng

Các bước tiếp theo- CLI Guide — Làm chủ giao diện đầu cuối

Cấu hình — Tùy chỉnh thiết lập của bạn
Cổng nhắn tin — Kết nối Telegram, Discord, Slack, WhatsApp, Signal, Email hoặc Trợ lý tại nhà
Công cụ & Bộ công cụ — Khám phá các khả năng sẵn có

1. Cài đặt Hermes Agent

2. Thiết lập nhà cung cấp

3. Bắt đầu trò chuyện

4. Dùng thử các tính năng chính

Yêu cầu nó sử dụng terminal​

5. Khám phá thêm

Thiết lập terminal có hộp cát​

Kết nối nền tảng nhắn tin​

Thêm chế độ giọng nói​

Lên lịch các tác vụ tự động​

Kỹ năng duyệt và cài đặt​

Sử dụng Hermes bên trong trình soạn thảo thông qua ACP​

Dùng thử máy chủ MCP​