AI Agent · Nous Research

Hermes Agent
Cheat Sheet

Self-improving AI agent với built-in learning loop — tạo skills từ kinh nghiệm, ghi nhớ qua các session, sống trên 20+ messaging platforms. Chạy local, Docker, SSH, Daytona, Modal hay Singularity.

Nous Research
Tổng quan

Hermes Agent là gì?

Không phải coding copilot gắn vào IDE, cũng không phải chatbot bọc quanh một API. Hermes là autonomous agent — càng chạy lâu càng khôn ra. Cài lên $5 VPS, GPU cluster, hay serverless (Daytona, Modal — gần như miễn phí khi idle). Nhắn cho nó qua Telegram trong khi nó tự làm việc trên VM bạn không bao giờ phải SSH vào.

1

Closed learning loop

Agent-curated memory với periodic nudges, tự tạo & tự cải tiến skills khi dùng, FTS5 cross-session recall + LLM summarization.

2

Runs anywhere

6 terminal backends: local, Docker, SSH, Daytona, Singularity, Modal. Daytona & Modal hibernate khi idle.

3

20+ messaging platforms

CLI, Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost, Email, SMS, Teams, Home Assistant… cùng một gateway.

4

Built by model trainers

Tạo bởi Nous Research — lab đứng sau Hermes, Nomos, Psyche. Hoạt động với Nous Portal, OpenRouter, OpenAI, Anthropic, Google.

Getting Started

Quick Start

1

Install (Linux/macOS/WSL2)

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

Android (Termux) dùng đúng lệnh này — installer tự nhận diện.

2

Configure

hermes config edit
hermes config set OPENROUTER_API_KEY sk-or-...

API keys lưu vào ~/.hermes/.env; mọi cài đặt khác vào config.yaml.

3

Launch

hermes

Interactive session với streaming tool output, slash autocomplete, multi-line input.

Windows (native, PowerShell) — beta sớm:
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

Reference

CLI Commands

Running Hermes

hermesStart interactive session
hermes --tuiLaunch modern TUI (Ink)
hermes chat -q "Hello"Single query mode (non-interactive)
hermes --continueResume most recent session (-c)
hermes --resume <id>Resume specific session (-r)
hermes -wRun in isolated git worktree
hermes chat --verboseDebug output

Model & Provider

--model anthropic/claude-sonnet-4Pin specific model
--provider nousUse Nous Portal
--provider openrouterForce OpenRouter
--toolsets "web,terminal,skills"Limit available toolsets
-s skill-a,skill-bPreload skills at launch

Config Management

hermes configView current config
hermes config editOpen config.yaml in $EDITOR
hermes config set KEY VALSet value (auto-routes secrets to .env)
hermes config checkCheck for missing options after update
hermes config migrateAdd missing options interactively

Update & Uninstall

hermes updateUpdate to latest version
hermes --versionShow installed version
hermes uninstallRemove Hermes (keeps ~/.hermes/)
In-session

Slash Commands

Gõ / để mở autocomplete. Lệnh không phân biệt hoa-thường. Skills cài trong ~/.hermes/skills/ tự thành slash command.

Core

/helpShow command help
/modelShow/change current model
/toolsList available tools
/usageToken + cost breakdown
/compressCompress context khi gần đầy
/title My sessionĐặt tên cho session hiện tại

Skills & Background

/skills browseBrowse Skills Hub
/background <prompt>Run prompt in background session
/reasoning highTăng reasoning effort
/skinSwitch CLI skin

Voice Mode

/voice onEnable voice (Ctrl+B để record)
/voice ttsToggle spoken playback

Personality

/personality conciseTrả lời ngắn gọn
/personality technicalTone kỹ thuật, chi tiết
/personality teacherGiải thích như giáo viên
/personality pirateBuilt-in fun (kawaii, noir, surfer…)
Keybindings

Keyboard Shortcuts

Input

EnterSend message
Alt+Enter / Ctrl+JNew line (multi-line)
Ctrl+GMở input buffer trong $EDITOR
Ctrl+X Ctrl+EEmacs-style external editor
TabAccept auto-suggest / autocomplete slash
Alt+VPaste image từ clipboard
Ctrl+VPaste text + auto-attach images

Control

Ctrl+CInterrupt agent (double-press để exit)
Ctrl+DExit
Ctrl+ZSuspend to background (Unix); fg để resume
Ctrl+BStart/stop voice recording (khi voice mode ON)
Setup

Configuration

~/.hermes/config.yamlSettings

Mọi non-secret settings: model, terminal backend, memory, toolsets, personalities.

model: anthropic/claude-sonnet-4
terminal:
  backend: docker
  timeout: 180
~/.hermes/.envSecrets

API keys, bot tokens, passwords. Auto-redact trong logs.

OPENROUTER_API_KEY=sk-or-...
ANTHROPIC_API_KEY=sk-ant-...
TELEGRAM_BOT_TOKEN=...
Env Var SubstitutionYAML

Tham chiếu env vars trong YAML bằng ${VAR_NAME}.

auxiliary:
  vision:
    api_key: ${GOOGLE_API_KEY}
Quick CommandsCustom

Định nghĩa slash command chạy shell ngay, không qua LLM.

quick_commands:
  status:
    type: exec
    command: systemctl status hermes-agent

Precedence: CLI flags > config.yaml > .env > built-in defaults. hermes config set tự định tuyến secrets vào .env.

Where it runs

Terminal Backends

Backend quyết định nơi shell command thực thi. Đổi qua hermes config set terminal.backend <name>.

localDefault

Chạy trực tiếp trên máy hiện tại. Nhanh nhất, không sandbox.

dockerSandbox

Container cô lập trên cùng máy. Image mặc định nikolaik/python-nodejs.

sshRemote

Server từ xa. Nhắn tin từ Telegram trong khi agent làm việc trên VM.

modalServerless

Modal cloud sandbox. Hibernate khi idle — chi phí gần như 0.

daytonaServerless

Daytona workspace. Persistent state, hibernate khi idle.

singularityHPC

Singularity/Apptainer container — lý tưởng cho GPU cluster có policy.

Messaging Gateway

Lives where you do

Một gateway, 20+ platform. Hermes có thể nhắn lại từ bất kỳ kênh nào sau khi bạn cấu hình token.

Chat Platforms

Telegrambot token
DiscordDM + channels + voice
SlackSocket Mode
WhatsAppBaileys bridge
Signalsignal-cli
Matrix / Mattermostnative
Microsoft Teamsplugin

Other Channels

EmailIMAP/SMTP
SMSTwilio
Home Assistantconversation agent
WebhooksGitHub, GitLab, etc.
DingTalk / Feishu / WeComenterprise CN
QQ Bot / Yuanbao / LINEregional
API serverOpenAI-compatible
The learning loop

Skills · Memory · MCP

Skills SystemProcedural

Hermes tự tạo skills từ trải nghiệm, tự cải tiến khi dùng. Compatible với chuẩn mở agentskills.io. Mỗi skill ở ~/.hermes/skills/ tự thành slash command.

CuratorAuto-maintain

Background process theo dõi usage, đánh dấu skill stale, archive khi không dùng, LLM-driven review để cải tiến.

MemoryPersistent

MEMORY.md + USER.md + FTS5 cross-session search. Agent tự nudge mình ghi nhớ.

Context FilesProject

.hermes.md, AGENTS.md, CLAUDE.md, global SOUL.md tự inject vào mọi conversation.

MCP IntegrationProtocol

Kết nối tới bất kỳ MCP server nào, filter tools an toàn, mở rộng năng lực Hermes mà không thổi context.

DelegationParallel

Spawn isolated subagent qua delegate_task. Programmatic Tool Calling collapse multi-step pipeline thành 1 inference call.

Workflow

Một ngày với Hermes

Hermes Agent on a $5 VPS
$ hermes config set terminal.backend modal
# Run sandbox commands trên Modal serverless
$ hermes -s github-pr-workflow -q "Open PR cho auth refactor"
# Preload skill + single-query mode
/ /background draft release notes cho v1.2.0
# Background session — không block CLI
> Nhắn Hermes qua Telegram khi đang ngoài đường
# Cùng agent, cùng memory — chỉ khác kênh vào
⌘ Ctrl+B → voice → "kiểm tra deploy log"
# Voice mode trong CLI + Discord VC
Resources

Tài liệu & cộng đồng

Official DocsRead

Hướng dẫn đầy đủ cho install, config, features.

hermes-agent.nousresearch.com/docs
llms.txtFor agents

Doc index dạng machine-readable cho LLM (≈17 KB).

hermes-agent.nousresearch.com/docs/llms.txt
llms-full.txtOne-shot

Toàn bộ docs concat vào 1 markdown (≈1.8 MB) cho one-shot ingestion.

hermes-agent.nousresearch.com/docs/llms-full.txt
GitHub · DiscordCommunity

Source code, issues, skills hub, community channels.

github.com/NousResearch/hermes-agent