简报·YT
← 返回 GitHub 动态
NousResearch/hermes-agent · 📈 热门项目 已完成

NousResearch/hermes-agent v2026.8.31

2026-08-31 19:29 · ⭐ 23.9万 · GitHub Release 原文 ↗
#智能代理 #多代理协作 #开源项目

NousResearch/hermes-agent v2026.8.31

NousResearch 的 Hermes Agent 是一个开源 AI 代理框架,核心是让多个 AI 代理协同完成复杂任务,并支持桌面应用、CLI、定时任务与工具调用。这个版本(v0.21.0 / Pantheon Release)的核心是:把 Bot Mode 内置为桌面应用默认功能,让多个具名代理像团队同事一样在群聊中协作,并围绕它大幅强化了定时任务记忆、子代理实时操控、MCP 管理和 CLI 体验。

版本规模

新增能力

安全与修复

回滚与注意

▸ Release Notes 英文原文(39683 字符)
# Hermes Agent v0.21.0 (v2026.8.31) **Release Date:** August 31, 2026 **Since v0.20.0:** ~5,800 commits · ~2,475 merged PRs · ~5,680 files changed · ~869,000 insertions · ~135,000 deletions · **~2,100 issues closed** · 760+ contributors > **The Pantheon Release.** v0.20.0 made Hermes the herald — he spoke, and he carried word to other agents. In v0.21.0 the gods assemble. Bot Mode ships built into the desktop app: a society of named agents with their own faces and group chats, where your bots talk to each other — and to you — like a team, not a toolbox. Around that spine: cron jobs gained memory and continuity so scheduled agents actually learn between runs, subagents can be steered live mid-flight, the MCP surface became a real command center, and the agent can now drive the desktop's own browser. This release rolls up everything from the v0.20.1–v0.20.6 infrastructure patch tags — those windows are fully documented here. --- ## ✨ Highlights - **Bot Mode — your agents become a society, built in** — Bot Mode is now a bundled, default-on part of the desktop app: every agent profile gets a name, a deterministic avatar face (with randomize/lock controls), and a place in a shared roster. Create Discord-style group chats where multiple bots and you talk in one room, @-mention any bot from the composer, and give rooms names and pictures. Before, "multi-agent" meant plumbing; now it looks like a chat app full of coworkers. ([#87886](https://github.com/NousResearch/hermes-agent/pull/87886), [#88243](https://github.com/NousResearch/hermes-agent/pull/88243), [#89386](https://github.com/NousResearch/hermes-agent/pull/89386), [#96726](https://github.com/NousResearch/hermes-agent/pull/96726) — @teknium1, @OutThisLife, @dokterdok) - **`hermes peer` — bot-to-bot DMs between your agents** — Any Hermes agent can now message any other by handle, across profiles and gateways, from the CLI or from inside a conversation. Ask your research bot to hand findings to your coding bot and get the reply back where you can read it. Replies land in each agent's canonical Bot Chat, so conversations between agents are durable and inspectable, not fire-and-forget. ([#88725](https://github.com/NousResearch/hermes-agent/pull/88725), [#88178](https://github.com/NousResearch/hermes-agent/pull/88178), [#91487](https://github.com/NousResearch/hermes-agent/pull/91487) — @teknium1) - **Cron jobs that remember** — Scheduled jobs stopped being goldfish. Cron agents now load and update persistent memory like every other agent, `continuity=true` carries each run's output into the next (so a monitor can dedupe against what it already reported), every job gets a durable notepad scratchpad, monitor-mode jobs skip the LLM entirely when nothing changed, and cron output can land in a bot's canonical Bot Chat — where the bot actually responds. Your 9am briefing job now knows what it told you yesterday. ([#91447](https://github.com/NousResearch/hermes-agent/pull/91447), [#80774](https://github.com/NousResearch/hermes-agent/pull/80774), [#81139](https://github.com/NousResearch/hermes-agent/pull/81139), [#81138](https://github.com/NousResearch/hermes-agent/pull/81138), [#91487](https://github.com/NousResearch/hermes-agent/pull/91487) — @teknium1, @smwbev) - **Steer your subagents while they run** — `delegate_task` gained live orchestration: list running children, steer one mid-flight with a course correction, or stop it early and keep the partial result. Add optional JSON-schema validation on child outputs, per-delegation cost surfaced in results, and raised defaults (250 iterations, 10 concurrent children) — delegation went from fire-and-pray to actually managed parallel work. ([#85232](https://github.com/NousResearch/hermes-agent/pull/85232), [#81144](https://github.com/NousResearch/hermes-agent/pull/81144), [#81142](https://github.com/NousResearch/hermes-agent/pull/81142), [#86506](https://github.com/NousResearch/hermes-agent/pull/86506), [#86745](https://github.com/NousResearch/hermes-agent/pull/86745) — @teknium1) - **The MCP command center** — MCP servers and the catalog merged into one coherent desktop page with drag-in "paste anything" import, background health checks that nudge you to re-auth before a tool call fails, a fleet cost/usage overlay showing schema token estimates and 30-day usage per server, and `hermes://` deep links that install an MCP server with explicit confirmation. Managing twenty MCP servers used to be config-file archaeology; now it's a dashboard. ([#87525](https://github.com/NousResearch/hermes-agent/pull/87525), [#87572](https://github.com/NousResearch/hermes-agent/pull/87572), [#87576](https://github.com/NousResearch/hermes-agent/pull/87576), [#87579](https://github.com/NousResearch/hermes-agent/pull/87579), [#87581](https://github.com/NousResearch/hermes-agent/pull/87581) — @teknium1) - **A CLI power wave** — Ctrl+P opens a fuzzy command palette, the `/model` picker filters as you type, `/status` shows reasoning mode, pending approvals, and context usage, and the status bar can display live cache-hit %, latency, and tokens/sec with per-field toggles. Plus: a global emergency stop, session pin/unpin, rotating task-oriented composer placeholders — and Ghostty-level **terminal pets**, because a companion should have a companion. ([#90730](https://github.com/NousResearch/hermes-agent/pull/90730), [#90717](https://github.com/NousResearch/hermes-agent/pull/90717), [#90745](https://github.com/NousResearch/hermes-agent/pull/90745), [#98250](https://github.com/NousResearch/hermes-agent/pull/98250), [#98282](https://github.com/NousResearch/hermes-agent/pull/98282), [#97666](https://github.com/NousResearch/hermes-agent/pull/97666) — @teknium1, and salvaged community work) - **The agent drives the desktop's browser** — The in-app browser stopped being a window the agent could only look at: Hermes now navigates, clicks, and reads it directly, and pages can be popped out to your system browser with full link context menus. Ask it to walk a docs site or debug a web app and watch it happen inside your own app. ([#90197](https://github.com/NousResearch/hermes-agent/pull/90197), [#89366](https://github.com/NousResearch/hermes-agent/pull/89366) — @OutThisLife, @ethernet8023) - **Six new providers and a model catalog wave** — Meta Model API (Muse Spark) arrives as a built-in provider, alongside CommandCode, Tencent TokenPlan, Nebius Token Factory, Ramp Router, and Actual Computer. The catalogs picked up GLM-5.3-Flash, qwen3.8-max/flash, Gemini 3.7 Flash, MiniMax M3 free, and Nemotron 3.5 Lightning — and `model_overrides` lets you patch any model's context window or pricing yourself without waiting on a release. ([#88565](https://github.com/NousResearch/hermes-agent/pull/88565), [#88308](https://github.com/NousResearch/hermes-agent/pull/88308), [#97917](https://github.com/NousResearch/hermes-agent/pull/97917), [#97916](https://github.com/NousResearch/hermes-agent/pull/97916), [#97915](https://github.com/NousResearch/hermes-agent/pull/97915), [#85560](https://github.com/NousResearch/hermes-agent/pull/85560) — @teknium1 and community) - **Security hardening across the board** — Protected agent-instruction files (AGENTS.md, skills, memory stores) now always require write approval so a prompt-injected agent can't quietly rewrite its own standing orders. A deep redaction sweep closed secret-leak gaps across terminal errors, `.env` file reads, checkpoints, and ACP logs; the approval system learned Windows destructive commands; and macOS permission grants finally survive updates via a stable TCC signing identity. ([#81152](https://github.com/NousResearch/hermes-agent/pull/81152), [#80965](https://github.com/NousResearch/hermes-agent/pull/80965), [#84428](https://github.com/NousResearch/hermes-agent/pull/84428), [#95091](https://github.com/NousResearch/hermes-agent/pull/95091) — @teknium1 and community) --- ## 🏗️ Core Agent & Architecture ### Providers & Models - **New providers:** Actual Computer inference ([#79644](https://github.com/NousResearch/hermes-agent/pull/79644), salvage of #26491), CommandCode with GOAT/Pro/Max plans ([#88308](https://github.com/NousResearch/hermes-agent/pull/88308), salvage of #32909), Meta Model API (Muse Spark) as a built-in provider plugin ([#88565](https://github.com/NousResearch/hermes-agent/pull/88565)), Tencent TokenPlan ([#97917](https://github.com/NousResearch/hermes-agent/pull/97917)), Nebius Token Factory ([#97916](https://github.com/NousResearch/hermes-agent/pull/97916)), and Ramp Router ([#97915](https://github.com/NousResearch/hermes-agent/pull/97915)). - **Model catalog wave:** qwen3.8-max and qwen3.8-flash ([#78024](https://github.com/NousResearch/hermes-agent/pull/78024), [#96979](https://github.com/NousResearch/hermes-agent/pull/96979)), Gemini 3.7 Flash ([#85526](https://github.com/NousResearch/hermes-agent/pull/85526)), GLM-5.3-Flash across OpenRouter/Nous/z.ai/OpenCode ([#95621](https://github.com/NousResearch/hermes-agent/pull/95621), [#96293](https://github.com/NousResearch/hermes-agent/pull/96293)), MiniMax M3 + Inkling free SKUs ([#96264](https://github.com/NousResearch/hermes-agent/pull/96264)), Nemotron 3.5 Lightning ([#84645](https://github.com/NousResearch/hermes-agent/pull/84645)), Meta Muse Spark 1.2 ([#88600](https://github.com/NousResearch/hermes-agent/pull/88600)). - **Per-model metadata overrides** via `model_overrides` config — patch context windows, pricing, or capabilities for any model without waiting on a release ([#85560](https://github.com/NousResearch/hermes-agent/pull/85560)). - **Data-training-tier warnings** — a unified selection-guard registry warns you across every picker surface when a model trains on your data ([#85917](https://github.com/NousResearch/hermes-agent/pull/85917)). - **Pip-installed model providers** discovered via entry points — third parties can ship providers as packages ([#85504](https://github.com/NousResearch/hermes-agent/pull/85504), salvage #81419). - **Prompt caching engaged for LiteLLM Claude** on the OpenAI wire ([#87517](https://github.com/NousResearch/hermes-agent/pull/87517) — @kshitijk4poor) and api.meta.ai routed through the Responses API for caching ([#88601](https://github.com/NousResearch/hermes-agent/pull/88601)). - **Codex GPT context defaults** back to the verified 272K, with explicit -900k picker variants for the large window ([#92797](https://github.com/NousResearch/hermes-agent/pull/92797)). ### Agent Loop & Reliability - **Stalled-provider recovery** — a stalled stream no longer leaves Desktop silent or burns the retry budget ([#87236](https://github.com/NousResearch/hermes-agent/pull/87236) — @fangliquanflq). - **MoA hardening cluster** — the Mixture-of-Agents facade now survives client rebuilds, stream retries, provider rotation, and fallback/restore without leaking prepared requests to native clients ([#90212](https://github.com/NousResearch/hermes-agent/pull/90212) and siblings). - **Structured-output resilience** — auxiliary calls translate `response_format` for Anthropic wires and retry when a provider rejects structured output ([#89589](https://github.com/NousResearch/hermes-agent/pull/89589) — @ethernet8023). - **Compression: lean tail mode** + a compaction recall eval harness to measure what compression actually preserves ([#87326](https://github.com/NousResearch/hermes-agent/pull/87326)). - **Oversized tool results spill to cache** instead of being truncated in sandbox-less sessions ([#89028](https://github.com/NousResearch/hermes-agent/pull/89028)). - **`clarify` asks multiple independent questions in one call** — one form instead of a chain of round-trips ([#89467](https://github.com/NousResearch/hermes-agent/pull/89467) — @ethernet8023). - **Verify subsystem** (port from superagent-ai/grok-cli): run-recipe detection + environment manifest so "it works" claims are backed by detected build/test commands ([#80686](https://github.com/NousResearch/hermes-agent/pull/80686)). ### Sessions & State - **Resumed transcripts never re-append** — `_db_persisted` stamped at row load time ([#92539](https://github.com/NousResearch/hermes-agent/pull/92539) — @kshitijk4poor). - **SessionDB context-manager protocol** for leak-free DB lifecycles ([#88048](https://github.com/NousResearch/hermes-agent/pull/88048) — @jackulau). - **Instant session naming** from the opening message, with sticky titles across resume ([#81985](https://github.com/NousResearch/hermes-agent/pull/81985) — @OutThisLife). - **Session pin/unpin from the CLI** — durable keep flags ([#80761](https://github.com/NousResearch/hermes-agent/pull/80761)). ## 📱 Messaging Platforms (Gateway) - **Slack native live cards** — real streaming replies via chat.startStream plus opt-in plan/task cards for tool progress ([#85476](https://github.com/NousResearch/hermes-agent/pull/85476)); outbound link-preview suppression across native and relay planes ([#95142](https://github.com/NousResearch/hermes-agent/pull/95142) — @benbarclay). - **Telegram inline picker** — every command and skill searchable via @botname, bypassing Telegram's command-menu cap ([#98317](https://github.com/NousResearch/hermes-agent/pull/98317)). - **Relay matured** — native static/dynamic plugin initialization ([#77915](https://github.com/NousResearch/hermes-agent/pull/77915) — @bbednarski9), live-card ops with draft streaming + task cards ([#85796](https://github.com/NousResearch/hermes-agent/pull/85796) — @victor-kyriazakos), session-span segmentation ([#85467](https://github.com/NousResearch/hermes-agent/pull/85467)), voice-note STT restored over the relay lane ([#95274](https://github.com/NousResearch/hermes-agent/pull/95274) — @benbarclay), transport dedupe/fail-fast fixes ([#89584](https://github.com/NousResearch/hermes-agent/pull/89584)). - **Gateway control socket** — fleet consumers query the gateway itself (identify/status), and updaters pause gateways gracefully instead of tree-killing them ([#92447](https://github.com/NousResearch/hermes-agent/pull/92447), [#95695](https://github.com/NousResearch/hermes-agent/pull/95695)). - **Selective multiplex profile serving** ([#83400](https://github.com/NousResearch/hermes-agent/pull/83400)), per-profile MCP lifecycle RPCs ([#86473](https://github.com/NousResearch/hermes-agent/pull/86473)), roster previews showing the latest message ([#85905](https://github.com/NousResearch/hermes-agent/pull/85905)), concise background-process notifications by default ([#85877](https://github.com/NousResearch/hermes-agent/pull/85877)). - **Turn-reaper stack dumps** — when the watchdog fires, wedged worker stacks are captured for diagnosis ([#86248](https://github.com/NousResearch/hermes-agent/pull/86248)), with loop-watchdog tuning knobs wired end-to-end ([#92317](https://github.com/NousResearch/hermes-agent/pull/92317)). - **Split-delivery bug class closed** — swallowed finals and split deliveries fixed as a class ([#79669](https://github.com/NousResearch/hermes-agent/pull/79669) — @kshitijk4poor, salvages #78558). ## 🖥️ Desktop App - **Bot Mode built in** — see Highlights. Full sub-catalog: attributed agent-to-agent message cards ([#85855](https://github.com/NousResearch/hermes-agent/pull/85855)), sender-side delivery notices ([#85888](https://github.com/NousResearch/hermes-agent/pull/85888)), paint-first hydration for instant wakes ([#89510](https://github.com/NousResearch/hermes-agent/pull/89510)), editable group names and room pictures ([#89371](https://github.com/NousResearch/hermes-agent/pull/89371)), Routines pane ([#88731](https://github.com/NousResearch/hermes-agent/pull/88731)), rebuilt on the app design system ([#96726](https://github.com/NousResearch/hermes-agent/pull/96726) — @OutThisLife). - **In-app browser the agent can drive** — the agent uses the desktop's browser tab, not just looks at it ([#90197](https://github.com/NousResearch/hermes-agent/pull/90197) — @OutThisLife), with external-open + link context menus ([#89366](https://github.com/NousResearch/hermes-agent/pull/89366)). - **Detached update hand-off on every OS** — quit → update → reopen with a single shim window; Windows desktop updates no longer park on "Updating Hermes" ([#83634](https://github.com/NousResearch/hermes-agent/pull/83634), [#90937](https://github.com/NousResearch/hermes-agent/pull/90937), [#95897](https://github.com/NousResearch/hermes-agent/pull/95897)). - **Quality-of-life wave** — HUD snaps to cursor on ⌘⇧G ([#83130](https://github.com/NousResearch/hermes-agent/pull/83130)), paste into the composer without focusing it ([#84955](https://github.com/NousResearch/hermes-agent/pull/84955)), per-turn duration badges ([#87245](https://github.com/NousResearch/hermes-agent/pull/87245)), readable macOS window translucency ([#88744](https://github.com/NousResearch/hermes-agent/pull/88744)), Linux launcher entry ([#76456](https://github.com/NousResearch/hermes-agent/pull/76456)), Linux keychain auto-detection ([#84903](https://github.com/NousResearch/hermes-agent/pull/84903)), cron + blueprint recipes in the sidebar ([#85162](https://github.com/NousResearch/hermes-agent/pull/85162)). - **Send Diagnostics** — error cards can upload a redacted debug bundle with a support handoff ([#92020](https://github.com/NousResearch/hermes-agent/pull/92020)). - **Seq-stamped event replay** — lossless desktop reconnect over WebSocket ([#94219](https://github.com/NousResearch/hermes-agent/pull/94219) — @kshitijk4poor). - **God-file decomposition** — the desktop codebase refactored into atomic modules ([#89611](https://github.com/NousResearch/hermes-agent/pull/89611) — @OutThisLife). ## 🖥️ CLI & TUI - See Highlights for the power wave (command palette, fuzzy /model, richer /status, live status-bar metrics, pets). - **`hermes approval-check`** — dry-run approval verdicts for a command without running it ([#81137](https://github.com/NousResearch/hermes-agent/pull/81137)). - **Session titles in status bars** ([#81947](https://github.com/NousResearch/hermes-agent/pull/81947)); subagent model exposed in the auxiliary-models picker ([#80463](https://github.com/NousResearch/hermes-agent/pull/80463)). - **Ctrl+C fixed** — stopped pushing the Kitty keyboard protocol that broke interrupts ([#87074](https://github.com/NousResearch/hermes-agent/pull/87074)). ## 🔧 Tool System & MCP - **MCP command center** — see Highlights ([#87525](https://github.com/NousResearch/hermes-agent/pull/87525) et al.). - **Interrupted commands no longer poison cwd** — the terminal won't adopt a stale working directory after an interrupt ([#85654](https://github.com/NousResearch/hermes-agent/pull/85654) — @ethernet8023). - **Windows rename contention recovery** ([#84852](https://github.com/NousResearch/hermes-agent/pull/84852) — @OutThisLife); colon-bearing session IDs no longer break sandbox mounts ([#93488](https://github.com/NousResearch/hermes-agent/pull/93488), consolidated 6 PRs). - **Vision output uncapped** — aux vision calls stop clamping max_tokens ([#75253](https://github.com/NousResearch/hermes-agent/pull/75253) — @adikpb). - **Subagent work protected** — delegate no longer deletes a child's uncommitted work when git inspection fails ([#88419](https://github.com/NousResearch/hermes-agent/pull/88419) — @kshitijk4poor). ## 🧩 Skills Ecosystem - **Productivity skill wave** (salvaged from @community proposals): document-to-action-items, meeting-action-items, email-inbox-triage, github-issue-to-pr, weekly-review-planning, competitor-news-monitor, product-price-monitor, social-media-content-calendar ([#81185](https://github.com/NousResearch/hermes-agent/pull/81185), [#81749](https://github.com/NousResearch/hermes-agent/pull/81749), [#81672](https://github.com/NousResearch/hermes-agent/pull/81672), [#81708](https://github.com/NousResearch/hermes-agent/pull/81708), [#81936](https://github.com/NousResearch/hermes-agent/pull/81936), [#81945](https://github.com/NousResearch/hermes-agent/pull/81945), [#81906](https://github.com/NousResearch/hermes-agent/pull/81906), [#81942](https://github.com/NousResearch/hermes-agent/pull/81942)). - **HAR-derived API clients** — watch a website once, then call its hidden API directly with no browser ([#70823](https://github.com/NousResearch/hermes-agent/pull/70823)). - **publish-site** — versioned website publishing to GitHub/Cloudflare/Netlify Pages ([#72189](https://github.com/NousResearch/hermes-agent/pull/72189)); **session-librarian** for prompt-driven session management ([#84917](https://github.com/NousResearch/hermes-agent/pull/84917)); **blocked-page-recovery** fallback ladder ([#84906](https://github.com/NousResearch/hermes-agent/pull/84906)); **merge-reconciler** for neutral multi-agent conflict resolution ([#83063](https://github.com/NousResearch/hermes-agent/pull/83063)); Box productivity skill ([#85767](https://github.com/NousResearch/hermes-agent/pull/85767)); ast-grep codemods ([#80892](https://github.com/NousResearch/hermes-agent/pull/80892)); draw-your-font + simple-english optional skills ([#80814](https://github.com/NousResearch/hermes-agent/pull/80814), [#80811](https://github.com/NousResearch/hermes-agent/pull/80811)); plan-interrogation (evolved grill-me) ([#97831](https://github.com/NousResearch/hermes-agent/pull/97831)). - **Advisory SKILL.md linter on create** ([#81896](https://github.com/NousResearch/hermes-agent/pull/81896)); skills-hub live-repo fallback for missing optional skills ([#82780](https://github.com/NousResearch/hermes-agent/pull/82780)). ## ⏰ Cron, Delegation & Multi-Agent - **Cron memory + continuity** — see Highlights ([#91447](https://github.com/NousResearch/hermes-agent/pull/91447), [#80774](https://github.com/NousResearch/hermes-agent/pull/80774)). - **Monitor-mode jobs** with hash-suppressed change detection ([#81138](https://github.com/NousResearch/hermes-agent/pull/81138)); per-job durable notepads ([#81139](https://github.com/NousResearch/hermes-agent/pull/81139)); pre-dispatch config validation ([#81140](https://github.com/NousResearch/hermes-agent/pull/81140)); acked failure signatures stop re-pinging ([#95017](https://github.com/NousResearch/hermes-agent/pull/95017)); per-job reasoning-effort pinning ([#91244](https://github.com/NousResearch/hermes-agent/pull/91244)); "Trigger now" executes immediately and safely ([#70638](https://github.com/NousResearch/hermes-agent/pull/70638) — @smwbev); model-drift impact surfaced in Desktop ([#83266](https://github.com/NousResearch/hermes-agent/pull/83266) — @ctaylor86). - **Live subagent orchestration** — see Highlights ([#85232](https://github.com/NousResearch/hermes-agent/pull/85232)); structured-output schemas on delegate_task ([#81144](https://github.com/NousResearch/hermes-agent/pull/81144)); batch-quality validation before spawning ([#81141](https://github.com/NousResearch/hermes-agent/pull/81141)); truncation markers on capped children ([#86641](https://github.com/NousResearch/hermes-agent/pull/86641)). - **Kanban hardening** — collision-hotspot flagging ([#83428](https://github.com/NousResearch/hermes-agent/pull/83428)), split-brain decision-ownership contract ([#83424](https://github.com/NousResearch/hermes-agent/pull/83424)), memory-aware dispatch guard ([#88115](https://github.com/NousResearch/hermes-agent/pull/88115)), notify/wake delivery modes ([#85487](https://github.com/NousResearch/hermes-agent/pull/85487)). ## 📊 Observability - **Model/provider usage reporting** and bounded tool-metrics aggregation land as an observability subsystem ([#68881](https://github.com/NousResearch/hermes-agent/pull/68881), [#68882](https://github.com/NousResearch/hermes-agent/pull/68882) — @afourniernv), with lifecycle ops bounded so a wedged pipeline can never block the agent ([#83514](https://github.com/NousResearch/hermes-agent/pull/83514) — @victor-kyriazakos). ## 🔒 Security & Reliability - **Protected instruction files** — writes to AGENTS.md/skills/memory always require approval ([#81152](https://github.com/NousResearch/hermes-agent/pull/81152)). - **Redaction sweep** — emission gaps closed across env-name variants, control-splits, process(list), checkpoints ([#80965](https://github.com/NousResearch/hermes-agent/pull/80965)); `.env` reads redacted via file-read detection ([#80964](https://github.com/NousResearch/hermes-agent/pull/80964)); terminal exception results + ACP stderr ([#81675](https://github.com/NousResearch/hermes-agent/pull/81675), [#81686](https://github.com/NousResearch/hermes-agent/pull/81686)); SSH target logging ([#88232](https://github.com/NousResearch/hermes-agent/pull/88232)). - **Windows approval coverage** — destructive Windows commands and paths now trip the approval system ([#84428](https://github.com/NousResearch/hermes-agent/pull/84428)). - **Supply-chain response** — the Blender MCP catalog entry and skill were removed after an upstream compromise ([#83404](https://github.com/NousResearch/hermes-agent/pull/83404)); plugin installs get Tier-1 security scanning ([#80728](https://github.com/NousResearch/hermes-agent/pull/80728)). - **macOS TCC identity** — permission grants survive every update via `hermes desktop --setup-tcc-identity` ([#95091](https://github.com/NousResearch/hermes-agent/pull/95091)). - **PKCE cookie fix** — SameSite=None over HTTPS with a matching clear path ([#83536](https://github.com/NousResearch/hermes-agent/pull/83536) — @benbarclay). ## 🏗️ Infrastructure, CI & Packaging - **Real-OS CI** — macOS and Windows CI lanes with tests gated by real host OS ([#77992](https://github.com/NousResearch/hermes-agent/pull/77992) — @ethernet8023); work lanes on 32-core runners ([#92009](https://github.com/NousResearch/hermes-agent/pull/92009)); review comments + image builds moved out of the hot CI path ([#82668](https://github.com/NousResearch/hermes-agent/pull/82668)). - **Bootstrap installer** no longer waits on pipe EOF ([#90941](https://github.com/NousResearch/hermes-agent/pull/90941) — @OutThisLife). ## 🐛 Notable Bug Fixes - Desktop session races (Stop→edit/resend, submit ownership) fixed as a cluster ([#86594](https://github.com/NousResearch/hermes-agent/pull/86594)); workspace-pane idle flicker ([#97513](https://github.com/NousResearch/hermes-agent/pull/97513)); assistant-ui boundary recovery ([#81232](https://github.com/NousResearch/hermes-agent/pull/81232)). - Kanban schema re-creation when a cached DB path loses it ([#83619](https://github.com/NousResearch/hermes-agent/pull/83619) — @JoaoMarcos44). - Cron jobs no longer inherit a kanban worker's dispatcher identity ([#79657](https://github.com/NousResearch/hermes-agent/pull/79657) — @kshitijk4poor); relay-fronted Slack cron delivery ([#85340](https://github.com/NousResearch/hermes-agent/pull/85340) — @victor-kyriazakos). - Model-picker serves cached custom-provider catalogs on no-probe opens ([#81973](https://github.com/NousResearch/hermes-agent/pull/81973) — @austinpickett). - Docker sandbox MEDIA attachments no longer silently drop ([#94509](https://github.com/NousResearch/hermes-agent/pull/94509)); desktop binary attachments delivered into sandbox backends ([#81717](https://github.com/NousResearch/hermes-agent/pull/81717)). - Session-hygiene compaction cooldown escalates on repeat failures ([#79741](https://github.com/NousResearch/hermes-agent/pull/79741) — @kshitijk4poor). - Provider-injected parameter 400s retried instead of aborting the turn ([#91643](https://github.com/NousResearch/hermes-agent/pull/91643)). - …and roughly two thousand more closed issues' worth — this window averaged ~85 merged PRs per day. ## ↩️ Reverted in this window (not shipping) - **Model Council mode (/council)** — landed then reverted; not in this release. - **DCP context engine** — landed then reverted; not in this release. - **WS-only gateway server (#94245)** — merged then reverted (#96118); FastAPI remains on the desktop boot path. The seq-stamped event replay (#94219) DID ship. - Electron rolled back to 40.10.2; TCC interpreter anchor removed (superseded by the signing-identity approach that shipped). ## 👥 Contributors ### Core Team (Nous Research) - **@teknium1** — release direction, Bot Mode, MCP command center, cron memory, and ~1,340 merged PRs - **@kshitijk4poor** (374 PRs) — gateway delivery classes, session persistence, event replay, MoA/caching fixes - **@OutThisLife** (209 PRs) — desktop architecture, Bot Mode UI, in-app browser, update hand-off - **@ethernet8023** (38 PRs) — OS-gated CI lanes, clarify multi-question, tool cwd safety, aux structured-output resilience - **@benbarclay** (17 PRs) — relay voice STT, Slack link previews, PKCE - **@victor-kyriazakos** (15 PRs) — relay live cards, observability bounding - **@rob-maron**, **@austinpickett**, **@jquesnelle**, **@shannonsands** — providers, dashboard, model catalogs, and more ### Top Community Contributors (by merged PR count) - **@helix4u** (31 PRs) — wake-word capture, session UX, fix wave across desktop and gateway - **@fangliquanflq** (17 PRs) — stalled-provider recovery and agent-loop resilience - **@bbednarski9** — relay native plugin integration; **@HexLab98**, **@xxxigm**, **@afourniernv** (observability), **@liuhao1024**, **@Christopher-Schulze**, **@Adolanium**, **@webtecnica**, **@smwbev** (cron Trigger-now), **@ctaylor86** (cron drift in Desktop), **@JoaoMarcos44** (kanban schema recovery), **@jackulau** (SessionDB context manager), **@adikpb** (vision output caps), **@dokterdok** (Bot Mode unification), and many more. ### All Contributors Huge thanks to every one of the 760+ people who contributed code, co-authored fixes, or had their work salvaged into this release: @03farren, @0xarkstar, @0xGr1mm, @0xWhiteMage, @100yenadmin, @1052326311, @29206394, @2ndNatureAI, @3Nya3, @3x3xX3N0N, @404Dealer, @4adwentures, @5Hyeons, @686f6c61, @69k4xmdfm2-blip, @6ylqq, @75day, @a-espinoza, @A-Snegin, @a-yeyang, @a0000001, @A2chitect, @abitme, @abundantbeing, @acewong7, @acgh213, @adamcap926, @addelh, @adikpb, @Adolanium, @adurham, @adybag14-cyber, @afourniernv, @ag9920, @ahmadalzaro1, @Ahmett101, @ai-ag2026, @AIalliAI, @aider4ryder, @Ailirag, @Aintworth, @airo7, @AiwendilInTheWoods, @akivavh, @AL-ZiLLA, @Al3xand3r1987, @albertodepaola, @aldoeliacim, @aleksclark, @AlexanderPrendota, @alexdev03, @AlexFucuson9, @AlexGabbia, @AlexMnrs, @algf, @Allecpu, @allin2, @alt-glitch, @amanning3390, @andrexibiza, @andyst-dev, @angel12, @angeon922-collab, @Angriff36, @aniruddhaadak80, @annguyenNous, @anuvratrastogi, @Aoshi-Dev, @appletechie, @arccat-114, @arcimun, @ArthurFranckPat, @aryaxo, @asdasdadhj, @ashah360, @AshuJoshi, @asimons81, @assimovt, @austinpickett, @AVW7, @Axmr1, @aydnOktay, @ayushnangia, @baihemax, @bananawalnut, @Bartok9, @bashrusakh, @bbednarski9, @BearHuddleston, @benbarclay, @benfrank241, @beplee, @bgrablin, @bka9, @BkashJEE, @BlackishGreen33, @BlakeB254, @blunkjamie-dev, @BobClawblaw, @bradmarshall987, @brian717, @briandevans, @BrianFranco, @BrinShadewater, @brucexu-eth, @BrunoBza, @buffpesos, @burak33bb, @C-EXCITE-STUDIO, @c-pompa, @cadezhou, @calvinnwq, @capt-marbles, @carbongotfound, @carlotestor, @Carry00, @cation98, @ccowan93, @cedricziel, @cervantesh, @cfdude, @Chadmc9889, @CharZhou, @chelsealong, @chesterXalan, @chillerno1, @Christopher-Schulze, @chukirk-svg, @cicav, @citizendev9c, @cj52973, @clarkvines, @ClintonEmok, @clyu168, @cmoiccool, @codexbt, @coe0718, @Cossackx, @coygeek, @crazyhulk, @CrazyWillBear, @criptogus, @cryptoyasenka, @ctaylor86, @cvillarroel2, @cxxCoolStar, @cycorld, @dagbs, @damadorPL, @DanBennettUK, @DanDo385, @DannyFengTianYu, @Dannyzen, @danspicytaco, @dante32683, @darko-mesaros, @daromaj, @david-bartos-phrase, @davidgut1982, @DavidMetcalfe, @davidneyravyr, @daxro, @dcdexhome, @deacon-botdoctor, @deadczarvc, @deaneeth, @DECRUX9812, @deepeet-git, @deniqlab, @DeseretSaint, @dhanesh, @Dhruv7201, @dhruvkej9, @digitalbase, @DmytroVolodymyrson, @dokterdok, @Dolverin, @dombejar, @doncazper, @dougatbuck, @douxy1994, @dpersek, @dplush, @Drexuxux, @drissman, @dromai, @dtownsel, @duclucky, @Dudeman456, @Dusk1e, @dvbaecker, @e-macgregor, @EAbaracus, @eaglezzz0522-cloud, @Eapwrk, @easyvibecoding, @echoes666, @egilewski, @ehz0ah, @ekinnee, @ekzhang, @elbukott1, @elisam0, @elphamale, @ElSnacko, @embwl0x, @emozilla, @EMT5320, @EndeavorYen, @Enough1122, @enwaiax, @epeterpanz, @EpicIsTheOne, @eric-senyao, @ernst-bablick, @Eros-ITA, @erosika, @ethernet8023, @etzelvon, @EvanProgramming, @EvenXieWF, @explainanalyze, @f-trycua, @fanfan343, @fangliquanflq, @fattchris, @felix-windsor, @Finn763, @flaviovargasbrandao, @Fly-onlyone, @flyingdoubleG, @forkercat, @francialisomlimoeiro, @francip, @frankmendes1979, @fred0m, @frendo, @frizikk, @frohsinnllc, @Frowtek, @fukutake1207, @fyzanshaik, @GarlicGo, @Gateton, @georgell-ceo, @gfriesen1, @gigabyte22, @gigashad, @gijoby, @gitong, @gkd2323c, @gnanirahulnutakki, @GodsBoy, @gokay-ai, @goktugvatandas, @golldyck, @goodchang77, @GottZ, @grahfmusic, @gregorustar-maker, @greyvito, @gsy324, @guanla-zz, @guilhermeartileshubsai, @guilhermeraiuga, @h-mascot, @h8hawk, @Haakam21, @Haik-G, @halaprix, @Halldrix, @handnewb, @Hangzian, @hanhvs, @hansai-art, @HAOWANG116, @HarishDarko, @hbentel, @helix4u, @HenryGHJ, @hermias1, @HexLab98, @hillimited, @Hjharris1, @hkfiberlaser-svg, @honor2030, @howdeploy, @hsearcy, @huklaa, @hustwkr, @hutao562, @hxwvaa, @IAvecilla, @icemeng, @infinitycrew39, @infocentr, @InphinitiZ, @insane66613, @Inspired-by-Atmosphere, @intelac, @intellectronica, @isak-ialogics, @ishanparihar, @isheng-eqi, @Ishman82, @iskysun96, @iso2kx, @itsflownium, @izumi0uu, @Jaaneek, @Jackal991, @jackijianxa, @jackoconner45, @jackulau, @jaimedhenriques, @james47kjv, @jbagdonas, @jcjc81, @jdgg777, @jeeves-assistant, @jeff-mettel, @Jefftree, @JElfferich, @jeremyrandria-debug, @JinUltimate1995, @jirathip-k, @jmmaloney4, @JoaoMarcos44, @joe-rodgers, @joe050860, @John-Lussier, @Johnny-xuan, @johnrazmus, @johnsonAyo, @jonpol01, @JonthanaHanh, @JoshPaulie, @Jreevo, @jtstothard, @Julientalbot, @justcarlosm, @justinbowes, @justinjohnson25600, @jwtor7, @k0rnacki, @kadiratesdev, @Kailigithub, @kaishi00, @KarateWilly, @kas-cor, @katie-lpd, @Kavyrocom, @KBANTH, @kchernev, @KeaneYan, @kernel-t1, @KeroZelvin, @kerpopule, @KHALIDagara, @KhanCold, @khanhngoo, @KIAgent01, @kim-miram, @kimyxx, @Kinkoolino-Hermes, @kinsolee, @kitsonk, @klaus765, @koltyj, @konsisumer, @kronexoi, @krunkosaurus, @kshitijk4poor, @kudapara, @kvnloo, @kweiner, @kyssta-exe, @Kyzcreig, @laithrw, @lakshyaag-tavily, @landaun, @laulopezreal, @laviesony, @lazy-idler, @LBeghini, @leeclouddragon, @Leegenux, @LemonSchneid, @LeonardoLGDS, @leonphull, @LeonSGP43, @lepetitprince716-prog, @Lesnak1, @lesterlxt, @lesyuk, @lEWFkRAD, @lextiz, @lgy1027, @Lidang-Jiang, @lilShawtty-byte, @lin-hongkuan, @liuhao1024, @liusencomic-cyber, @lkz-de, @loafoe, @locker95, @LordMelkor, @lorzl, @lost9999, @loulanyue, @LovePlayCode, @luckygreen, @lukeroberts, @luoxiao6645, @luxles, @m1k3s0, @Mabolla, @MagMueller, @magnus919, @magnuslundstedt, @MaheshBhushan, @MarcoFernstaedt, @mariobgsp, @marketing2981, @markmcd, @markmnl, @MarkVLK, @marzukia, @Mat-London, @matsvarn, @mattprusak, @MaximCrabbe, @maxmilian, @mehmetkr-31, @Mengchee118, @menhguin, @metamindedu, @michaelHMK, @michaelsam94, @milnerrad, @MindDragonLabs, @misterdas, @mjolley9, @mmcallister8, @mmcclean-aws, @mmchuangyt-ai, @moisesvalero, @mollusk, @monerostar, @Morad37, @mrkillbob, @mrmixx-max, @mrsucesso, @MrTheSoulz, @MustafaK99, @myk0la-b, @mzkarami, @n-leezy, @n1majne3, @NaMinhyeok, @nanami7777777, @nankingjing, @natebransc, @nateEc, @Navlem, @nbxuhk, @nductien, @Ne0teric, @NealZhouPanda, @necoweb3, @negroni334, @nftpoetrist, @nicochase, @Nicolas-Formenton, @nicolasdmolina, @nikitaBarkov, @NikolaRHristov, @noahingh, @nolanchic, @NorethSea, @notkisk, @notwitcheer, @NousResearch, @null-runner, @ojassharma7, @oliver-mee, @olympusbuildz, @OmarB97, @ooiuuii, @openclaww-xz, @opti-josh-holt, @osgeek90, @ousiaresearch, @OutThisLife, @Owen-narcissus, @paoloantinori, @Parker-Fawcett, @pasevin, @pasmud, @PaulBlackSwan, @paultaki, @peetteerr, @pefontana, @Per0-1, @pierrenode, @PINKIIILQWQ, @pittosporum-seu, @pju-hoge, @plcunha, @Pluviobyte, @pmos69, @pnascimento9596, @poisdahl, @potatosalad, @prashantjain25, @PRATHAMESH75, @professorpalmer, @projetsjsl, @protas-box, @qazasdsdqaza, @QDung210, @qixuancao, @QuarkAssistant, @quocanh261997, @ragingbulld, @rainbowgore, @rapsealk, @Raven26-VooDoo, @RaviTharuma, @RayCharlizard, @razultull, @re-ITRT, @Reksely, @RelaxJonh, @repfigit, @RGerrish, @RibatTRW, @RichardGuan1, @RichardHojunJang, @richardhowes, @RickyYii, @rikkarth, @rille111, @Ringo6107, @rjhilgefort, @rjvandeve, @rkfshakti, @rlaope, @Rmohid, @rob-maron, @rodrigogs, @royalaid, @royzhrxy-glitch, @rroverin, @rshi0212, @rsk-731, @rtcopenclawgh, @ruangraung, @rudrakshchahal, @ruochu88s, @rweddle, @ryankhart, @S-Claw, @Sahil-SS9, @salch-cred, @sam7894604, @samclams, @saralilyb, @sashmatash, @sasquatch9818, @satotakumi, @ScaleLeanChris, @SeashoreShi, @serefyarar, @shaase-ctrl, @shali10, @shannonsands, @shanthans-es, @ShaoRou459, @shaqalaka, @shauneccles, @Shedrackeze002, @SHL0MS, @ShonnQ, @Shotflame, @silence-de, @simonvanlaak, @SiteupAgencia, @sjungwon03, @skip-agent, @SLC-BTC, @Slobaka, @smarzola, @smause, @SmelterLabs, @smfworks, @smwbev, @sohomsahaun, @Soju06, @SolshineCode, @solyanviktor-star, @somewheresy, @SongotenU, @songshikang0111, @Sora-bluesky, @SouthpawIN, @spfcraze, @srojk34, @Starfie1d1272, @starship-s, @StellarisW, @steveonjava, @Stoltemberg, @strnadchristopher, @strzhao, @sujeet111, @suntech-wang, @supotato-ipj, @sweetcornna, @sycamoregroupltd, @sylbae, @tachyon-r, @tauros1983, @terry197913, @texasich, @th3sull1van, @thacid22, @thatssoheil, @TheAngryPit, @thebizfixer, @thejpanganiban, @thelonewander3r, @thenabbu, @TheophilusChinomona, @TheSmokeDev, @TheTom, @thomasbek3, @tigercraft4, @Tigrannnnnnn, @Tilly-YL, @tmchow, @tmielika, @tmingos, @TMShiroiko, @TomAce7, @tomatau, @Tomenatore, @Tommy00748, @TomSpoct, @toprakeker, @Tranquil-Flow, @tranquilflow, @trevornk, @trippyogi, @troyrowe-resource, @tt-a1i, @tuancookiez-hub, @tugrulguner, @TurgutKural, @tyfcontent, @Ufonik88, @UniversePeak, @unsupportedpastels, @uperLu, @uttkarsh-26, @V0v1kkkAssistant, @vadelma-agent, @vanniaxel06, @VBS2004, @verybigdog, @victor-kyriazakos, @victorftrdba, @victoronwuanaku, @victorv2i, @vignesh-oai, @vinayshah1998, @vinsew, @VIVAAN-DHAWAN, @vKongv, @vondelomlo, @vorburger, @wanglufei-567, @wangs1203, @wanquanY, @wdon, @web-wyf, @webdevtodayjason, @webtecnica, @webtoolbox, @weisiwu, @weismanfamily, @Wenfengcheng, @wesleysimplicio, @westkite1201, @whirmill, @whisky0809, @whoislikemiha, @will-lynas, @willfrombr, @wingkwong, @Wintle, @wiseconnex, @wo-o, @WolframRavenwolf, @WolftacDigital, @worlldz, @wz-heng, @x1051445024, @x7peeps, @xaviersudre, @XiaoZAZA, @xkam7ar, @xrwang8, @xthezealot, @xxxigm, @Yanir-R, @YappLeCunt, @yatesjalex, @yflmq001, @ygd58, @Yiipu, @yingliang-zhang, @yinkev, @Yishova, @yoniebans, @youtiaowei, @ypQQ1984, @yu-xin-c, @yukinomon, @yuric, @YusenZhang0601, @YuYigeng, @yuzilongleif-collab, @yy28, @zabih-sudo, @ZachariahChu, @zakame, @zapabob, @zccyman, @zcj1122-rgb, @zengzheqing, @Zeraphim, @Zeus-Deus, @zgqq, @zhangfei1231231-sketch, @zhao0112, @zhaomengfan, @ZHJay, @zhongwater123, @zhuermu, @zoidypuh, @zons-zhaozhy, @zuowen7, @zyz619963502zyz, @zzz163519 Also: @mkoistinen, @JoaoMarcos44, @StanleyStetson. --- **Full Changelog**: [v2026.8.3...v2026.8.31](https://github.com/NousResearch/hermes-agent/compare/v2026.8.3...v2026.8.31) *This release rolls up and fully documents the v0.20.1, v0.20.2, v0.20.3, v0.20.5, and v0.20.6 patch-tag windows (Aug 13–27), whose notes were deferred to this minor per the rollup-release policy.*
▸ 主项目介绍 · NousResearch/hermes-agent
▸ README 原文(同步于 2026-07-19 13:26)
<p align="center"> <img src="assets/banner.png" alt="Hermes Agent" width="100%"> </p> # Hermes Agent ☤ <p align="center"> <a href="https://hermes-agent.nousresearch.com/docs/"><img src="https://img.shields.io/badge/Docs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge" alt="Documentation"></a> <a href="https://discord.gg/NousResearch"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a> <a href="https://github.com/NousResearch/hermes-agent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License: MIT"></a> <a href="https://nousresearch.com"><img src="https://img.shields.io/badge/Built%20by-Nous%20Research-blueviolet?style=for-the-badge" alt="Built by Nous Research"></a> <a href="README.md"><img src="https://img.shields.io/badge/Lang-English-lightgrey?style=for-the-badge" alt="English"></a> <a href="README.ur-pk.md"><img src="https://img.shields.io/badge/Lang-اردو-green?style=for-the-badge" alt="اردو"></a> </p> **由 [Nous Research](https://nousresearch.com) 构建的自进化 AI 代理。** 它是唯一内置学习闭环的智能代理——从经验中创建技能,在使用中改进技能,主动持久化知识,搜索过往对话,并在跨会话中逐步构建对你的深度理解。可以在 $5 的 VPS 上运行,也可以在 GPU 集群上运行,或者使用几乎零成本的 Serverless 基础设施。它不绑定你的笔记本——你可以在 Telegram 上与它对话,而它在云端 VM 上工作。 支持任意模型——[Nous Portal](https://portal.nousresearch.com)、[OpenRouter](https://openrouter.ai)(200+ 模型)、[NVIDIA NIM](https://build.nvidia.com)(Nemotron)、[小米 MiMo](https://platform.xiaomimimo.com)、[z.ai/GLM](https://z.ai)、[Kimi/Moonshot](https://platform.moonshot.ai)、[MiniMax](https://www.minimax.io)、[Hugging Face](https://huggingface.co)、OpenAI,或自定义端点。使用 `hermes model` 即可切换——无需改代码,无锁定。 <table> <tr><td><b>真正的终端界面</b></td><td>完整的 TUI,支持多行编辑、斜杠命令自动补全、对话历史、中断重定向和流式工具输出。</td></tr> <tr><td><b>随你所在</b></td><td>Telegram、Discord、Slack、WhatsApp、Signal 和 CLI——全部从单个网关进程运行。语音备忘录转写、跨平台对话连续性。</td></tr> <tr><td><b>闭环学习</b></td><td>代理管理记忆并定期自我提醒。复杂任务后自动创建技能。技能在使用中自我改进。FTS5 会话搜索配合 LLM 摘要实现跨会话回溯。<a href="https://github.com/plastic-labs/honcho">Honcho</a> 辩证式用户建模。兼容 <a href="https://agentskills.io">agentskills.io</a> 开放标准。</td></tr> <tr><td><b>定时自动化</b></td><td>内置 cron 调度器,支持向任何平台投递。日报、夜间备份、周审计——全部用自然语言描述,无人值守运行。</td></tr> <tr><td><b>委派与并行</b></td><td>生成隔离子代理处理并行工作流。编写 Python 脚本通过 RPC 调用工具,将多步管道压缩为零上下文开销的轮次。</td></tr> <tr><td><b>随处运行</b></td><td>六种终端后端——本地、Docker、SSH、Daytona、Singularity 和 Modal。Daytona 和 Modal 提供 Serverless 持久化——代理环境空闲时休眠、按需唤醒,空闲期间几乎零成本。$5 VPS 或 GPU 集群都能跑。</td></tr> <tr><td><b>研究就绪</b></td><td>批量轨迹生成、轨迹压缩——用于训练下一代工具调用模型。</td></tr> </table> --- ## 快速安装 ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` 支持 Linux、macOS、WSL2 和 Android (Termux)。安装程序会自动处理平台特定的配置。 > **Android / Termux:** 已测试的手动安装路径请参考 [Termux 指南](https://hermes-agent.nousresearch.com/docs/getting-started/termux)。在 Termux 上,Hermes 会安装精选的 `.[termux]` 扩展,因为完整的 `.[all]` 扩展会拉取 Android 不兼容的语音依赖。 > > **Windows:** 在 PowerShell 中运行: > ```powershell > iex (irm https://hermes-agent.nousresearch.com/install.ps1) > ``` > 安装完成后,可能需要重启终端,然后运行 `hermes` 开始对话。 安装后: ```bash source ~/.bashrc # 重新加载 shell(或: source ~/.zshrc) hermes # 开始对话! ``` --- ## 快速入门 ```bash hermes # 交互式 CLI — 开始对话 hermes model # 选择 LLM 提供商和模型 hermes tools # 配置启用的工具 hermes config set # 设置单个配置项 hermes gateway # 启动消息网关(Telegram、Discord 等) hermes setup # 运行完整设置向导(一次性配置所有内容) hermes claw migrate # 从 OpenClaw 迁移(如果来自 OpenClaw) hermes update # 更新到最新版本 hermes doctor # 诊断问题 ``` 📖 **[完整文档 →](https://hermes-agent.nousresearch.com/docs/)** --- ## 省去到处收集 API Key — Nous Portal Hermes 始终允许你使用任意服务商,这点不会改变。但如果你不想为模型、网页搜索、图像生成、TTS、云浏览器分别去申请五个不同的 API Key,**[Nous Portal](https://portal.nousresearch.com)** 用一个订阅就能覆盖全部: - **300+ 模型** — 用 `/model <name>` 随时切换 - **Tool Gateway** — 网页搜索(Firecrawl)、图像生成(FAL)、文本转语音(OpenAI)、云浏览器(Browser Use),全部通过订阅托管。无需额外注册任何账户。 全新安装时一条命令即可: ```bash hermes setup --portal ``` 它会通过 OAuth 登录、把 Nous 设为推理服务商,并启用 Tool Gateway。随时用 `hermes portal info` 查看路由状态。完整说明见 [Tool Gateway 文档](https://hermes-agent.nousresearch.com/docs/user-guide/features/tool-gateway)。 你随时可以按工具单独切回自己的 API Key — Gateway 是按工具粒度生效的,不是一刀切。 --- ## CLI 与消息平台 快速对照 Hermes 有两种入口:用 `hermes` 启动终端 UI,或运行网关从 Telegram、Discord、Slack、WhatsApp、Signal 或 Email 与之对话。进入对话后,许多斜杠命令在两种界面中通用。 | 操作 | CLI | 消息平台 | |------|-----|----------| | 开始对话 | `hermes` | 运行 `hermes gateway setup` + `hermes gateway start`,然后给机器人发消息 | | 开始新对话 | `/new` 或 `/reset` | `/new` 或 `/reset` | | 更换模型 | `/model [provider:model]` | `/model [provider:model]` | | 设置人格 | `/personality [name]` | `/personality [name]` | | 重试或撤销上一轮 | `/retry`、`/undo` | `/retry`、`/undo` | | 压缩上下文 / 查看用量 | `/compress`、`/usage`、`/insights [--days N]` | `/compress`、`/usage`、`/insights [days]` | | 浏览技能 | `/skills` 或 `/<skill-name>` | `/skills` 或 `/<skill-name>` | | 中断当前工作 | `Ctrl+C` 或发送新消息 | `/stop` 或发送新消息 | | 平台特定状态 | `/platforms` | `/status`、`/sethome` | 完整命令列表请参阅 [CLI 指南](https://hermes-agent.nousresearch.com/docs/user-guide/cli) 和 [消息网关指南](https://hermes-agent.nousresearch.com/docs/user-guide/messaging)。 --- ## 文档 所有文档位于 **[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs/)**: | 章节 | 内容 | |------|------| | [快速开始](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) | 安装 → 设置 → 2 分钟内开始首次对话 | | [CLI 使用](https://hermes-agent.nousresearch.com/docs/user-guide/cli) | 命令、快捷键、人格、会话 | | [配置](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) | 配置文件、提供商、模型、所有选项 | | [消息网关](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) | Telegram、Discord、Slack、WhatsApp、Signal、Home Assistant | | [安全](https://hermes-agent.nousresearch.com/docs/user-guide/security) | 命令审批、DM 配对、容器隔离 | | [工具与工具集](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) | 40+ 工具、工具集系统、终端后端 | | [技能系统](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) | 过程记忆、技能中心、创建技能 | | [记忆](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) | 持久记忆、用户画像、最佳实践 | | [MCP 集成](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) | 连接任意 MCP 服务器扩展能力 | | [定时调度](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) | 定时任务与平台投递 | | [上下文文件](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files) | 影响每次对话的项目上下文 | | [架构](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) | 项目结构、代理循环、关键类 | | [贡献](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) | 开发设置、PR 流程、代码风格 | | [CLI 参考](https://hermes-agent.nousresearch.com/docs/reference/cli-commands) | 所有命令和标志 | | [环境变量](https://hermes-agent.nousresearch.com/docs/reference/environment-variables) | 完整环境变量参考 | --- ## 从 OpenClaw 迁移 如果你来自 OpenClaw,Hermes 可以自动导入你的设置、记忆、技能和 API 密钥。 **首次安装时:** 安装向导(`hermes setup`)会自动检测 `~/.openclaw` 并在配置开始前提供迁移选项。 **安装后任意时间:** ```bash hermes claw migrate # 交互式迁移(完整预设) hermes claw migrate --dry-run # 预览将要迁移的内容 hermes claw migrate --preset user-data # 仅迁移用户数据,不含密钥 hermes claw migrate --overwrite # 覆盖已有冲突 ``` 导入内容: - **SOUL.md** — 人格文件 - **记忆** — MEMORY.md 和 USER.md 条目 - **技能** — 用户创建的技能 → `~/.hermes/skills/openclaw-imports/` - **命令白名单** — 审批模式 - **消息设置** — 平台配置、允许用户、工作目录 - **API 密钥** — 白名单中的密钥(Telegram、OpenRouter、OpenAI、Anthropic、ElevenLabs) - **TTS 资产** — 工作区音频文件 - **工作区指令** — AGENTS.md(使用 `--workspace-target`) 使用 `hermes claw migrate --help` 查看所有选项,或使用 `openclaw-migration` 技能进行交互式代理引导迁移(含干运行预览)。 --- ## 贡献 欢迎贡献!请参阅 [贡献指南](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) 了解开发设置、代码风格和 PR 流程。 贡献者快速开始——使用标准安装器,然后在它创建的完整 git checkout 中开发: `$HERMES_HOME/hermes-agent`(通常是 `~/.hermes/hermes-agent`)。这会匹配 `hermes update`、托管 venv、lazy dependencies、gateway 和 docs tooling 使用的布局。 ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash cd "${HERMES_HOME:-$HOME/.hermes}/hermes-agent" uv pip install -e ".[all,dev]" scripts/run_tests.sh ``` 手动克隆备用路径(用于一次性 clone / CI,或你明确不想使用 managed install layout 时): ```bash curl -LsSf https://astral.sh/uv/install.sh | sh uv venv venv --python 3.11 source venv/bin/activate uv pip install -e ".[all,dev]" python -m pytest tests/ -q ``` --- ## 社区 - 💬 [Discord](https://discord.gg/NousResearch) - 📚 [技能中心](https://agentskills.io) - 🐛 [问题反馈](https://github.com/NousResearch/hermes-agent/issues) - 💡 [讨论区](https://github.com/NousResearch/hermes-agent/discussions) - 🔌 [HermesClaw](https://github.com/AaronWong1999/hermesclaw) — 社区微信桥接:在同一微信账号上运行 Hermes Agent 和 OpenClaw。 --- ## 许可证 MIT — 详见 [LICENSE](LICENSE)。 由 [Nous Research](https://nousresearch.com) 构建。