Hermes Workspace: Trung tâm điều khiển mã nguồn mở cho AI Agent của bạn

Tóm tắt nhanh

Hermes Workspace là một workspace mã nguồn mở, self-hosted dành cho Hermes Agent của Nous Research – không phải một “chat wrapper” thông thường, mà là trung tâm điều khiển gồm Chat, Memory, Skills, MCP, Files, Terminal, Conductor và Swarm Mode trong cùng một giao diện.

Triết lý zero-fork: chỉ clone, không fork, chạy trên hermes-agent nguyên bản cài qua installer chính thức của Nous.

Có ba con đường cài đặt: Docker Compose (~2 phút), one-line install cho macOS/Linux (~3 phút), hoặc attach vào hermes-agent có sẵn (~1 phút).

Hoạt động với bất kỳ backend OpenAI-compatible nào: Hermes Agent gateway, Ollama, LM Studio, vLLM, Atomic Chat, llama.cpp…

Là PWA, hỗ trợ truy cập qua Tailscale/LAN, có auth middleware, CSP và path-traversal guard – phù hợp cho self-hoster và home lab.

Trong thời đại AI agent bùng nổ, việc quản lý nhiều agent, sessions, skills và memory thường khiến người dùng “chết chìm” trong một mớ tab trình duyệt. Hermes Workspace sinh ra để giải quyết vấn đề đó – biến công việc với AI agent thành một hệ thống thống nhất, có thể kiểm soát từ một giao diện duy nhất.

Hermes Workspace là gì

Hermes Workspace là native web workspace dành cho Hermes Agent, được phát triển bởi cộng đồng tại outsourc-e/hermes-workspace. Khác với các giao diện chat thông thường, nó cung cấp một “control plane” hoàn chỉnh để:

Trò chuyện thời gian thực với agent qua SSE streaming, render tool call, hỗ trợ markdown và syntax highlighting.
Duyệt, tìm kiếm và chỉnh sửa Memory của agent qua live markdown editor.
Quản lý hơn 2.000 Skills với origin badges, filter và marketplace.
Kết nối MCP (Model Context Protocol) servers, catalog và marketplace tích hợp sẵn.
Sử dụng Files browser (Monaco editor) và Terminal PTY cross-platform ngay trong workspace.
Triển khai Swarm Mode: nhiều Hermes Agent workers chạy nền tmux, dispatch theo vai trò (builders, reviewers, docs, research, ops, QA…).
Theo dõi Operations dashboard với profile presets như Sage, Trader, Builder, Scribe, Ops.

Workspace là UI, còn Hermes Agent là “bộ não”. Hai bên giao tiếp qua hai HTTP service trên localhost (hoặc mạng nội bộ): gateway port :8642 và dashboard port :9119.

Vì sao nên sử dụng Hermes Workspace

Mã nguồn mở và self-hosted hoàn toàn

Toàn bộ dữ liệu – chat, memory, skills, files – đều nằm trên máy của bạn. Không có dịch vụ đám mây trung gian, không có telemetry ẩn. Đây là điểm cộng lớn so với các giải pháp SaaS đóng kín.

Zero-fork architecture

Workspace chạy trên hermes-agent nguyên bản từ Nous Research. Bạn không cần fork, không cần patch – khi Nous cập nhật agent, bạn chỉ cần pull về và tiếp tục dùng. Conductor thông minh đến mức: nếu dashboard có mission API thì dùng, không có thì fallback sang Workspace-native Swarm dispatch (mode: native-swarm).

Tương thích đa backend

Bất kỳ server OpenAI-compatible nào hỗ trợ POST /v1/chat/completions và GET /v1/models đều có thể dùng được – từ Ollama, LM Studio, vLLM cho đến llama.cpp hay LocalAI.

Yêu cầu hệ thống

Trước khi cài đặt, bạn cần chuẩn bị:

Node.js 22+ (bắt buộc cho workspace).
Một backend OpenAI-compatible – có thể là Hermes Agent gateway, Ollama, hoặc bất kỳ server tương đương nào.
Python 3.11+ (tùy chọn, nếu muốn chạy Hermes Agent gateway local).
pnpm để quản lý dependency.
Hệ điều hành: macOS, Linux, hoặc Windows với WSL.

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

Có ba con đường, hãy chọn cách phù hợp với bạn.

Cách 1: One-line install (nhanh nhất, ~3 phút)

Phù hợp cho dev local trên macOS/Linux:

curl -fsSL https://raw.githubusercontent.com/outsourc-e/hermes-workspace/main/install.sh | bash

Script này sẽ tự động cài hermes-agent qua installer chính thức của Nous, clone repo workspace, tạo .env và cài dependency. Sau đó mở hai terminal:

# Terminal 1 - khởi động Hermes gateway
hermes gateway run

# Terminal 2 - khởi động workspace
cd ~/hermes-workspace && pnpm dev

Mở trình duyệt tại http://localhost:3000 để bắt đầu.

Cách 2: Attach vào hermes-agent có sẵn (~1 phút)

Nếu bạn đã cài hermes-agent từ trước:

git clone https://github.com/outsourc-e/hermes-workspace.git
cd hermes-workspace
pnpm install
cp .env.example .env

echo 'HERMES_API_URL=http://127.0.0.1:8642' >> .env
echo 'HERMES_DASHBOARD_URL=http://127.0.0.1:9119' >> .env

pnpm dev

Trước khi mở workspace, hãy verify hai service:

curl http://127.0.0.1:8642/health      # gateway trả về {"status":"ok"}
curl http://127.0.0.1:9119/api/status  # dashboard trả về metadata

Cách 3: Manual install với backend OpenAI-compatible

Nếu chỉ muốn dùng Ollama hoặc LM Studio mà không cần gateway, đây là Portable Mode:

# Khởi động Ollama
OLLAMA_ORIGINS=* ollama serve

# Trỏ workspace vào Ollama
HERMES_API_URL=http://127.0.0.1:11434 pnpm dev

Chat sẽ hoạt động ngay. Sessions, memory, skills sẽ hiển thị “Not Available” – điều này bình thường ở Portable Mode.

Biến môi trường quan trọng

Các biến cần biết trong file .env:

HERMES_API_URL=http://127.0.0.1:8642        # Gateway URL - bắt buộc
HERMES_DASHBOARD_URL=http://127.0.0.1:9119  # Dashboard - mở khóa sessions/skills/MCP/jobs
# HERMES_API_TOKEN=***                      # Chỉ cần nếu gateway bật API_SERVER_KEY
# HERMES_PASSWORD=***                       # Bảo vệ UI bằng mật khẩu
# OPENAI_API_KEY=sk-...                     # Khóa provider tương ứng nếu dùng

Sử dụng Hermes Workspace

Sau khi cài đặt thành công, bạn sẽ thấy giao diện chính với các tab chức năng.

Chat và sessions

Tab Chat hỗ trợ multi-session, streaming SSE thời gian thực và render tool call rất sạch sẽ. Mỗi session được lưu vào dashboard, bạn có thể quay lại bất cứ lúc nào mà không mất ngữ cảnh.

Memory editor

Memory là điểm khác biệt lớn so với các UI chat khác – bạn có thể browse, search và chỉnh sửa trực tiếp memory của agent qua markdown editor. Đây là nơi bạn dạy agent những điều cần nhớ lâu dài.

Skills marketplace

Hơn 2.000 skills sẵn có, lọc theo origin (built-in, community, custom), kèm source path để bạn audit code trước khi dùng.

Conductor và Swarm Mode

Đây là tính năng “đỉnh” nhất. Conductor cho phép bạn dispatch mission cho nhiều agent cùng lúc – orchestrator sẽ phân rã task thành các sub-task và gửi đến workers phù hợp.

Swarm Mode đẩy ý tưởng này xa hơn: các Hermes Agent workers chạy nền tmux, giữ context qua nhiều task, rotate an toàn và báo cáo checkpoint có proof. Vai trò được phân chia rõ ràng: builders, reviewers, docs, research, ops, triage, QA, lab.

Truy cập từ xa qua Tailscale

Workspace là PWA – cài như app native trên iOS/Android và truy cập qua Tailnet. Trên server chạy workspace, set:

echo 'HERMES_API_URL=http://100.x.y.z:8642' >> .env
echo 'HERMES_DASHBOARD_URL=http://100.x.y.z:9119' >> .env
echo 'API_SERVER_HOST=0.0.0.0' >> ~/.hermes/.env

Restart gateway, dashboard và workspace. Giờ bạn có thể điều khiển agent farm từ điện thoại ở bất cứ đâu.

Bảo mật và best practices

Hermes Workspace tích hợp sẵn auth middleware trên mọi route, CSP, path-traversal guard và fail-closed remote bind. Tuy nhiên, vẫn nên:

Đặt HERMES_PASSWORD nếu UI tiếp cận được qua mạng.
Bật API_SERVER_KEY cho gateway khi expose ra LAN/Tailscale, và set HERMES_API_TOKEN tương ứng ở workspace.
Hạn chế bind 0.0.0.0 trừ khi thực sự cần truy cập từ xa – Tailscale là lựa chọn an toàn hơn so với mở cổng public.

Khắc phục sự cố thường gặp

Sessions/Memory/Skills hiển thị “Not Available”: dashboard chưa chạy, kiểm tra hermes dashboard ở port :9119.
Connection refused từ thiết bị khác: gateway đang bind 127.0.0.1, hãy set API_SERVER_HOST=0.0.0.0 trong ~/.hermes/.env.
Chat trả về 401: gateway có API_SERVER_KEY nhưng workspace chưa set HERMES_API_TOKEN.

Hermes Workspace là một trong những workspace AI agent mã nguồn mở hoàn thiện nhất hiện nay, đặc biệt phù hợp với những ai muốn tự host, kiểm soát dữ liệu và mở rộng quy mô agent theo kiểu swarm. Triết lý zero-fork, khả năng tương thích đa backend và kiến trúc PWA + Tailscale-friendly khiến nó trở thành lựa chọn đáng cân nhắc cho mọi developer, indie hacker và home lab enthusiast đang xây dựng AI agent pipeline riêng.

Duy Nghiện

Hãy làm khán giả, đừng làm nhân vật chính :)