Hermes Agent + DeepSeek trên mạng Gonka — tác nhân tự hành giá rẻ

Cài đặt Hermes (Linux, macOS, WSL2). Trình cài đặt chính thức sẽ tự động tải Python, Node.js, ripgrep và ffmpeg:

# Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# Windows (PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Sau khi cài xong, khởi động lại shell và kiểm tra:

source ~/.bashrc   # or ~/.zshrc
hermes             # interactive CLI

API key JoinGonka: nếu chưa có — hãy đăng ký tại gate.joingonka.ai/register, xác nhận địa chỉ — tài khoản sẽ nhận 3M token miễn phí — rồi tạo key với tiền tố jg- trong Dashboard. Một key và một số dư dùng được ngay cho mọi model.

Hermes hoạt động với mọi endpoint tương thích OpenAI: nếu máy chủ phản hồi tại /v1/chat/completions — bạn có thể trỏ Hermes tới đó. Gateway JoinGonka chính là một endpoint như vậy. Có ba cách cấu hình.

Cách 1: trình cài đặt của chúng tôi (một lệnh duy nhất, được khuyến nghị). Nó sẽ ghi nhà cung cấp vào config của Hermes, đặt DeepSeek V4 Flash làm model mặc định và kiểm tra bằng một request thực tế rằng gateway chấp nhận key và model:

npx @joingonka/setup --tool hermes

Cách 2: trình hướng dẫn cấu hình. Chạy trong terminal ngoài phiên đang hoạt động:

hermes model

Trong danh sách nhà cung cấp, chọn “Custom endpoint (self-hosted / VLLM / etc.)” và nhập ba giá trị:

• API base URL: https://gate.joingonka.ai/v1
• API key: jg-your-key
• Model name: deepseek-ai/DeepSeek-V4-Flash-0731

Cách 3: chỉnh sửa config. Hermes lưu cài đặt model trong ~/.hermes/config.yaml (trong bản dựng native cho Windows — %LOCALAPPDATA%\hermes\config.yaml) — đây là nguồn chân lý duy nhất. Thêm section:

# ~/.hermes/config.yaml
model:
  provider: custom
  default: deepseek-ai/DeepSeek-V4-Flash-0731
  base_url: https://gate.joingonka.ai/v1
  api_key: jg-your-key

Tên model được ghi vào key default — đây là key chuẩn tắc của Hermes. Dòng model: bên trong block chỉ là bí danh dự phòng: nó không có tác dụng nếu default đã được đặt (ví dụ bởi trình hướng dẫn cấu hình), vì vậy khi chỉnh sửa thủ công hãy thay đổi chính default.

⚠️ Key chỉ nằm trong model.api_key. Tài liệu của Hermes cho phép OPENAI_API_KEY trong ~/.hermes/.env, nhưng với custom endpoint điều này không hoạt động: Hermes chỉ đọc key từ model.api_key, và với key trong .env gateway sẽ trả về 401 Invalid API key. Đã kiểm chứng trên Hermes v0.20.4.

Kiểm tra: chạy hermes và nhập “Tạo file hello.py với hàm hello world”. Agent phải tạo file và hiển thị kết quả. Trạng thái cấu hình hiện tại có thể xem qua hermes config show | grep '^model\.' và hermes status.

Chuyển đổi nhanh: trong phiên bằng lệnh /model custom:deepseek-ai/DeepSeek-V4-Flash-0731. Còn /model custom không có tên sẽ tự động kéo model từ endpoint nếu chỉ có một model duy nhất ở đó.

Hermes là một công cụ tác nhân có bộ nhớ và kỹ năng. Nó không chỉ phản hồi một câu: nó đọc file, viết mã, chạy lệnh, nén ngữ cảnh, thực hiện các tác vụ nền dài thông qua bộ lập lịch. Mỗi hành động là một API-call, và trong một ngày làm việc tự hành, hàng chục triệu token sẽ được tích lũy. Hãy so sánh chi phí của các phiên điển hình:

Với JoinGonka Gateway, Hermes có thể được giữ chạy 24/7: báo cáo đêm, kiểm toán hàng tuần, tác vụ nền qua cron-scheduler — mà không cần lo lắng về chi phí. Với mức giá của Anthropic, mỗi lần chạy như vậy sẽ phải tính toán thủ công. Số dư ban đầu khi đăng ký là đủ để chạy tác nhân trên một tác vụ thực tế và xem mức tiêu thụ của chính bạn trước lần nạp tiền đầu tiên.

Thông qua Gateway, người dùng có thể truy cập ngay vào ba mô hình Gonka — tất cả đều hỗ trợ tool calling (OpenAI function calling) gốc, vì vậy các kỹ năng và công cụ của Hermes hoạt động đáng tin cậy mà không cần phân tích các phản hồi văn bản:

Về giới hạn token trong Hermes. Trong config.yaml, trường context_length là cửa sổ context toàn bộ (đầu vào + đầu ra), còn max_tokens là giới hạn chỉ dành cho độ dài phản hồi. Tốt nhất là không nên đặt cả hai: Hermes sẽ tự xác định các giá trị chính xác từ nhà cung cấp. Nếu bạn đặt max_tokens thủ công, hãy giữ nó trong giới hạn của mô hình: thông qua Gateway, đó là 32768 cho DeepSeek V4 Flash và 8192 cho MiniMax M2.7 và GLM-5.3 Flash. Bạn có thể thay đổi mô hình bất cứ lúc nào bằng lệnh hermes model hoặc ngay trong phiên làm việc thông qua /model.

Các công cụ terminal tương tự trong cơ sở kiến thức của chúng tôi: Claude Code, Cline.