Hermes Agent | Cài đặt giao diện (dashboard)

  Apr 19, 2026      2m      0   

 

Hermes Agent chạy headless mặc định, nhưng bạn có thể thêm dashboard để quản lý qua trình duyệt — theo dõi trạng thái, analytics, cron job và skill chỉ bằng vài dòng docker-compose.

Hermes Agent Dashboard (giao diện)

Hermes Agent mặc định là headless — không có giao diện người dùng. Bạn hoàn toàn có thể dùng Hermes Agent chỉ qua CLI hoặc nhắn tin Telegram mà không cần cài thêm gì. Tuy nhiên, dashboard là công cụ tiện lợi giúp bạn giám sát và quản lý agent qua trình duyệt, đặc biệt hữu ích khi Hermes Agent đang chạy trên VPS.

Dashboard cung cấp các tính năng chính:

• Trạng thái agent — kiểm tra agent đang hoạt động hay không, xem thông tin session hiện tại
• Lịch sử phiên (Session history) — xem lại các cuộc hội thoại và tác vụ đã thực hiện
• Analytics — phân tích token usage chi tiết theo ngày, theo model — hữu ích để kiểm soát chi phí API
• Logs — xem log hệ thống trực tiếp trên trình duyệt, không cần SSH
• Cron — quản lý các tác vụ lập lịch tự động
• Skills — xem danh sách skill, bao gồm các skill tự tạo qua vòng học của agent
• Configuration — xem và chỉnh cấu hình ngay trên giao diện

Cài đặt giao diện cho Hermes Agent (dashboard) dùng Docker Compose

File docker-compose.yml dưới đây mở rộng từ bài Cài đặt và cấu hình Hermes Agent trên VPS — chỉ cần thêm service dashboard vào stack hiện có.

Một vài lưu ý trước khi chạy:

• Service dashboard dùng cùng image với service hermes và mount vào cùng thư mục _data để đọc dữ liệu của agent
• Cả hai service giao tiếp qua internal network hermes-net — dashboard kết nối tới agent qua http://hermes:8642
• Flag --insecure được thêm để tránh lỗi "Refusing to bind to 0.0.0.0" khi chưa có HTTPS — không nên expose port này ra internet nếu không có reverse proxy và xác thực
• Dashboard cần vài phút để build lần đầu — hãy kiên nhẫn chờ sau khi chạy lệnh khởi động

Tham khảo thêm tài liệu: https://hermes-agent.nousresearch.com/docs/user-guide/docker#running-the-dashboard

hermes/docker-compose.yml

services:
  hermes:
    image: nousresearch/hermes-agent:latest             # https://hub.docker.com/r/nousresearch/hermes-agent/tags
    container_name: hermes
    restart: unless-stopped
    command: gateway run
    volumes:
      # - /var/run/docker.sock:/var/run/docker.sock     # WARNING: install Docker and Docker Compose inside container to use
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
      - ./_data:/opt/data
    # Điền API key model provider của bạn, và thông tin Telegram bot token, và user id của bạn
    environment:
      # Điền API key model provider của bạn, chọn một trong các provider, chú thích các biến còn lại không sử dụng
      # Tham khảo: https://hermes-agent.nousresearch.com/docs/integrations/providers
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - DEEPSEEK_API_KEY=${DEEPSEEK_API_KEY}
      # 1. Tạo bot mới và lấy token từ @BotFather
      # 2. Nhắn tin cho @userinfobot để lấy user id của tài khoản telegram bạn đang sử dụng (một dãy số)
      # Tham khảo: https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram
      - TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}
      - TELEGRAM_ALLOWED_USERS=${TELEGRAM_ALLOWED_USERS}
    deploy:
      resources:
        limits:
          memory: 4G
          cpus: "2.0"
    # Network for agent and dashboard
    networks:
      - hermes-net

  dashboard:
    image: nousresearch/hermes-agent:latest         # https://hub.docker.com/r/nousresearch/hermes-agent/tags
    container_name: hermes-dashboard
    restart: unless-stopped
    command: dashboard --host 0.0.0.0 --insecure
    ports:
      - "9119:9119"                                 # or "127.0.0.1:9119:9119"
    volumes:
      - ./_data:/opt/data                           # the same with service "hermes"
    environment:
      - GATEWAY_HEALTH_URL=http://hermes:8642
    networks:
      - hermes-net
    depends_on:
      - hermes
    deploy:
      resources:
        limits:
          memory: 512M
          cpus: "0.5"

networks:
  hermes-net:
    driver: bridge

Thực lệnh sau để triển khai Hermes Agent Dashboard:

docker-compose up -d
# hoặc
docker compose up -d

Sau đó truy cập vào địa chỉ sau bằng trình duyệt: localhost:9119 hoặc 0.0.0.0:9119. Chúc bạn triển khai thành công Hermes Agent Dashboard!

---

Hãy tham gia group Khám phá Hermes Agent: https://www.facebook.com/groups/hermes.agent.vn để cùng trao đổi và học hỏi.

Danh sách bài viết series Hermes Agent:

• Tut 1: Cài đặt và cấu hình Hermes Agent trên VPS ─ Docker Compose
• Tut 2: Fix DANGEROUS COMMAND Security scan ─ luôn duyệt lệnh tự động
• Tut 3: Cài đặt giao diện quản lý Hermes Agent (dashboard)

Tham gia ngay group trên Facebook để cùng thảo luận với đồng bọn nhé:

• Fanpage Minh: https://www.facebook.com/minhng.info
• Khám phá Hermes Agent: https://www.facebook.com/groups/hermes.agent.vn

Khám phá Hermes Agent

Minh Nguyen

Share this:

      

• #hermes-agent
• #docker-compose
• #docker