Bắt đầu nhanh
Hướng dẫn này sẽ giúp bạn cài đặt Hermes Agent, thiết lập một nhà cung cấp (provider) và thực hiện cuộc trò chuyện đầu tiên. Cuối cùng, bạn sẽ nắm được các tính năng chính và cách khám phá sâu hơn.
1. Cài đặt Hermes Agent
Chạy lệnh cài đặt rút gọn sau:
# Linux / macOS / WSL2
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
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 # hoặc 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 mặc định cho bạn. Để thay đổi sau này, hãy sử dụng một trong các lệnh sau:
hermes model # Chọn nhà cung cấp LLM và mô hình
hermes tools # Cấu hình bật/tắt các công cụ (tools)
hermes setup # Hoặc cấu hình tất cả cùng một lúc
Lệnh hermes model sẽ hướng dẫn bạn chọn nhà cung cấp suy luận:
| Nhà cung cấp | Giải thích | Cấu hình như thế nào |
|---|---|---|
| Nous Portal | Trả phí đăng ký, không cần cấu hình | Xác thực OAuth qua hermes model |
| OpenAI Codex | Xác thực ChatGPT OAuth, sử dụng mô hình Codex | Device code auth qua hermes model |
| Anthropic | Trực tiếp mô hình Claude (Pro/Max hoặc API key) | hermes model với xác thực Claude Code, hoặc API key Anthropic |
| OpenRouter | Chuyển tiếp đa nhà cung cấp tới nhiều mô hình | Nhập API key của bạn |
| Z.AI | Các mô hình GLM / được host bởi Zhipu | Tham số GLM_API_KEY / ZAI_API_KEY |
| Kimi / Moonshot | Mô hình lập trình và trò chuyện host trên Moonshot | Tham số KIMI_API_KEY |
| MiniMax | Endpoint quốc tế MiniMax | Tham số MINIMAX_API_KEY |
| MiniMax China | Endpoint khu vực Trung Quốc MiniMax | Tham số MINIMAX_CN_API_KEY |
| Alibaba Cloud | Các mô hình Qwen qua DashScope | Tham số DASHSCOPE_API_KEY |
| Hugging Face | Hơn 20 mô hình mở qua cùng mạng lưới (Qwen, DeepSeek, Kimi, v.v.) | Tham số HF_TOKEN |
| Kilo Code | Các mô hình host bởi KiloCode | Tham số KILOCODE_API_KEY |
| OpenCode Zen | Thanh toán theo mức sử dụng cho các LLM được chuẩn bị | Tham số OPENCODE_ZEN_API_KEY |
| OpenCode Go | Đăng ký $10/tháng cho các mô hình mở | Tham số OPENCODE_GO_API_KEY |
| DeepSeek | Truy cập API trực tiếp DeepSeek | Tham số DEEPSEEK_API_KEY |
| GitHub Copilot | Đăng ký tài khoản GitHub Copilot (GPT-5.x, Claude, Gemini, v.v.) | Xác thực OAuth qua hermes model, hoặc COPILOT_GITHUB_TOKEN / GH_TOKEN |
| GitHub Copilot ACP | Copilot ACP agent backend (bật CLI copilot cục bộ) | hermes model (cần CLI copilot + copilot login) |
| Vercel AI Gateway | Định tuyến Vercel AI Gateway | Tham số AI_GATEWAY_API_KEY |
| Endpoint tùy chỉnh | VLLM, SGLang, Ollama, hoặc bất kì API tương thích OpenAI nào | Tham số URL gốc + API key |
Bạn có thể chuyển đổi nhà cung cấp bất cứ lúc nào bằng hermes model — không cần thay đổi code, không bị khóa cứng (lock-in). Khi cấu hình endpoint tùy chỉnh, Hermes sẽ hỏi kích thước cửa sổ ngữ cảnh (context window) và tự động nhận diện nếu có thể. Xem Nhận diện độ dài ngữ cảnh để biết thêm về chi tiết.
3. Bắt đầu Trò chuyện
hermes
Đơn giản vậy thôi! Bạn sẽ thấy banner chào mừng hiển thị mô hình, công cụ khả dụng và các kỹ năng của bạn. Hãy nhập một tin nhắn và nhấn Enter.
❯ Bạn có thể giúp tôi điều gì?
Trợ lý ảo này có quyền truy cập vào các công cụ tìm kiếm web, thao tác file, lệnh terminal và nhiều tính năng khác — tất cả đã sẵn sàng để hoạt động.
4. Trải nghiệm Các Tính năng Chính
Yêu cầu dùng terminal
❯ Dung lượng ổ cứng của tôi thế nào? Hiển thị top 5 thư mục lớn nhất.
Trợ lý sẽ chạy lệnh terminal thay bạn và hiển thị kết quả.
Sử dụng slash command (Lệnh bắt đầu bằng dấu gạch chéo)
Nhập / để xem menu xổ xuống gợi ý tự động cho tất cả các lệnh:
| Lệnh | Phục vụ mục đích gì |
|---|---|
/help | Xem danh sách toàn bộ các lệnh |
/tools | Danh sách công cụ khả dụng |
/model | Chuyển đổi mô hình tương tác |
/personality pirate | Thử tính cách cướp biển vui nhộn |
/save | Lưu hội thoại lại |
Nhập nội dung trên nhiều dòng
Nhấn Alt+Enter hoặc Ctrl+J để gõ xuống dòng mới. Rất thích hợp khi bạn cần dán mã nguồn (code) hoặc đưa ra lời nhắc dài chi tiết.
Ngắt lời Agent
Nếu trợ lý thực thi câu hỏi quá lâu, hãy nhập tin nhắn mới và nhấn Enter — hệ thống sẽ ngắt lại yêu cầu đang chạy dở và ưu tiên chạy theo chỉ thị mới của bạn. Có thể sử dụng Ctrl+C.
Tiếp tục lại phiên kết nối (Session)
Khi bạn thoát ra khỏi phần mềm, hermes sẽ in ra lệnh để khôi phục:
hermes --continue # Tiếp tục lại phiên gần nhất
hermes -c # Cách viết gọn
5. Khám phá Thêm
Dưới đây là một số mẹo nên thử để tìm hiểu thêm:
Thiết lập sandbox cho terminal
Để an toàn, bạn nên khởi chạy agent bên trong môi trường Docker hoặc một máy chủ từ xa:
hermes config set terminal.backend docker # Cách ly trong Docker
hermes config set terminal.backend ssh # Máy chủ từ xa
Kết nối tới các ứng dụng nhắn tin
Bạn có thể trò chuyện với Hermes trên điện thoại qua Telegram, Discord, Slack, WhatsApp, Signal, Email, hoặc Home Assistant:
hermes gateway setup # Thiết lập đa nền tảng tương tác
Kích hoạt tính năng giọng nói
Bạn có muốn gõ lệnh âm thanh qua CLI hoặc đọc những câu trả lời?
pip install "hermes-agent[voice]"
# [Tùy chọn thêm] khuyến khích tải nền tảng text-to-speech nội bộ này miễn phí:
pip install faster-whisper
Sau đó bấm mở Hermes lên rồi bật tuỳ chọn:
/voice on
Nhấn Ctrl+B để ghi âm bản thu, hoặc dùng lệnh /voice tts để nghe giọng của Hermes. Xem Voice Mode để biết đầy đủ cấu hình từ CLI đến các mạng như Telegram, Discord...
Quản lý các lệnh chạy định kì
❯ Cứ 9h sáng mỗi ngày, hãy vào Hacker News tìm các tin nóng nhất về AI và gửi cho tôi bản tóm tắt vào Telegram.
Trợ lý AI sẽ thay bạn tự động hóa việc hẹn giờ (cron job) thông qua trình kết nối.
Duyệt và Cài đặt thư viện kỹ năng (Skills)
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
Mẹo hữu ích:
- Dùng cờ
--source skills-shđể mò thư mục mã nguồn mở tạiskills.sh. - Dùng
--source well-knowntheo kèm URL để dò lấy các plugin/.well-known/skills/index.json. - Sử dụng
--forcechỉ sau khi bạn phân tích rủi ro của plugin (skill) này. Tuy vậy, cờ force sẽ không thể kích hoạt chạy ứng dụng nếu chương trình bị báo lỗ hổng phần mềm (dangerous).
Ngoài ra, sử dụng nhanh /skills khi đang trong box chat nhé.
Tích hợp Hermes vào Text Editor của lập trình viên (ACP)
Hermes hoạt động với vai trò một hệ máy chủ xử lí (ACP) để tương thích với cấu hình VS Code, Zed và hệ sinh thái JetBrains:
pip install -e '.[acp]'
hermes acp
Mời bạn đọc qua ACP Editor Integration để tiến hành thiết lập.
Thử dùng các Server dạng MCP
Cài ứng dụng bên thứ 3 mở rộng (Model Context Protocol):
# Thêm vào file cấu hình của bạn ở thư mục ~/.hermes/config.yaml
mcp_servers:
github:
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"
Chỉ mục các công cụ
| Câu Lệnh | Mô Tả |
|---|---|
hermes | Mở chức năng chat AI |
hermes model | Trỏ đến phần tùy chọn LLM |
hermes tools | Kích hoạt các tool muốn sử dụng |
hermes setup | Màn hình setup từng bước thay vì thao tác chay (config hết sạch tật nấc một lúc) |
hermes doctor | Chỉ định tìm nguyên nhân sự cố rủi ro |
hermes update | Đưa app về cài bản update cuối cùng |
hermes gateway | Setup cổng nhắn tin kết hợp Telegram / Discord... |
hermes --continue | Lệnh này sẽ quay trở về phiên trước kia nhất |
Các bước tiếp theo
- Tài liệu thao tác CLI — Hiểu cặn kẽ command-line (giao diện Text) của app
- Tài liệu Cấu Hình — Biên dịch và thay đổi tuỳ chọn linh động
- Trung tâm Messaging Gateway — Phân công liên lạc với Signal, Telegram, Home Assistant...,
- Tài nguyên Công Cụ / Tools — Bơm khả năng cao cấp của Tool và Plug-ins