You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Merge pull request #5 from OnlyTerp/devin/1776393615-v0-10-refresh
- Add Parts 12-16: Web Dashboard, Nous Tool Gateway, Fast Mode +
background watchers + pluggable context engine, new messaging
platforms (iMessage, WeChat, Android/Termux), backup/import +
/debug + security hardening
- README: What's New section covering both v0.9.0 'everywhere' and
v0.10.0 'tool gateway' releases, updated TOC to 16 parts, expanded
provider table (Nous Portal, native xAI/Xiaomi, Kimi, z.ai, MiniMax,
Arcee, HF), Android/Termux install, dashboard quick start
- Part 4: reframe Telegram as one of 16 gateway platforms with
cross-references to the new adapters
- Part 9: native adapter matrix, Nous Portal OAuth flow, xAI live
search + MiMo reasoning modes, new provider config examples
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
### Make Your Hermes Agent Actually Work — Setup, Migration, Knowledge Graphs, Messaging, Skills, Memory, Models, Dashboard, Tool Gateway, and Recovery
6
+
#### Full setup walkthrough, OpenClaw migration, LightRAG graph RAG, 16 messaging platforms, on-the-fly skill creation, memory architecture, custom models, the new local web dashboard, Nous Tool Gateway, Fast Mode, backup/import, and crash recovery
7
7
8
8
*By Terp - [Terp AI Labs](https://x.com/OnlyTerp)*
9
9
10
10
---
11
11
12
+
## What's New (April 10–17, 2026)
13
+
14
+
Two major Hermes releases dropped this week. This guide is current as of both.
-**Local web dashboard** (`hermes dashboard`) — full browser UI for config, API keys, sessions, logs, analytics, cron, and skills. See [Part 12](./part12-web-dashboard.md).
19
+
-**Fast Mode** (`/fast`) — priority-tier inference on OpenAI & Anthropic, available on every gateway platform, not just the CLI. See [Part 14](./part14-fast-mode-watchers.md).
20
+
-**Three new messaging adapters** — iMessage (via BlueBubbles), WeChat/Weixin, and WeCom (Enterprise WeChat). Brings the total to **16 platforms**. See [Part 15](./part15-new-platforms.md).
21
+
-**Android / Termux** tested install path — run the full Hermes CLI on your phone. See [Part 15](./part15-new-platforms.md#android--termux-running-hermes-on-your-phone).
22
+
-**Background process monitoring** (`watch_patterns`) — real-time regex event hooks on long-running processes, no more polling. See [Part 14](./part14-fast-mode-watchers.md#background-process-monitoring-watch_patterns).
23
+
-**Pluggable context engine** — swap in a custom engine to filter memory, inject domain context, or pre-summarize tool output. See [Part 14](./part14-fast-mode-watchers.md#pluggable-context-engine).
24
+
-**`hermes backup` / `hermes import`** — first-class portable backups with interactive conflict resolution. See [Part 16](./part16-backup-debug.md).
25
+
-**Dashboard plugins** — third-party tabs that extend the web UI. See [Part 12](./part12-web-dashboard.md#dashboard-plugins-extend-the-ui).
26
+
-**Proxy support, webhook secret validation, SSRF protection, log redaction** — hardening pass across every adapter. See [Part 16](./part16-backup-debug.md#security-hardening-v09--v010-notes).
-**Nous Tool Gateway** — paid [Nous Portal](https://portal.nousresearch.com) subscribers get web search (Firecrawl), image generation (FAL FLUX 2 Pro), TTS (OpenAI), and browser automation (Browser Use) through their subscription — **no extra API keys**. Per-tool `use_gateway: true` with clean precedence over direct keys. See [Part 13](./part13-tool-gateway.md).
31
+
-**Native xAI and Xiaomi MiMo providers** — both now have first-class adapters with provider-specific features (Grok's live-X search, MiMo's reasoning modes), not just OpenRouter pass-through. See [Part 9](./part9-custom-models.md).
32
+
-**`/compress <topic>`** — guided compression that preserves detail relevant to a topic. See [Part 14](./part14-fast-mode-watchers.md#compress-topic--guided-compression).
33
+
-**`/debug` + `hermes debug share`** — single-command diagnostic bundler with upload endpoint for bug reports. See [Part 16](./part16-backup-debug.md#debug-and-hermes-debug-share).
34
+
-**Approval bypass inheritance for subagents** — subagents inherit the parent session's approval posture; override per delegation. See [Part 16](./part16-backup-debug.md#approval-bypass-for-trusted-subagents).
35
+
-`HERMES_ENABLE_NOUS_MANAGED_TOOLS` env flag **removed** — replaced by clean subscription detection + per-tool `use_gateway`. `hermes upgrade` migrates automatically.
36
+
37
+
---
38
+
12
39
## Table of Contents
13
40
14
-
1.[Setup](#part-1-setup-stop-fumbling-with-installation) — Install Hermes, configure your provider, first-run walkthrough
2.[SOUL.md Personality](#soulmd--give-your-agent-a-personality) — The Molty prompt, what good personality rules look like, how to fix a bland agent
16
43
3.[OpenClaw Migration](#part-2-openclaw-migration-dont-leave-your-knowledge-behind) — Move your OpenClaw data, config, skills, and memory into Hermes
17
44
4.[LightRAG — Graph RAG](#part-3-lightrag--graph-rag-that-actually-works) — Set up a knowledge graph that actually understands relationships, not just text similarity
@@ -20,9 +47,14 @@
20
47
7.[Context Compression](./part6-context-compression.md) — Fix the silent context loss bug, configure compression thresholds, survive long sessions
10.[Custom Model Providers](./part9-custom-models.md) — Cerebras, Fireworks, Ollama, model aliases, fallback chains
50
+
10.[Custom Model Providers](./part9-custom-models.md) — Cerebras, Fireworks, Ollama, native xAI/MiMo/z.ai/Kimi/MiniMax/Arcee, Nous Portal, model aliases, fallback chains
24
51
11.[SOUL.md Anti-Patterns](./part10-soul-antipatterns.md) — What makes an agent annoying vs useful, the formula that works
25
52
12.[Gateway Recovery](./part11-gateway-recovery.md) — Crash detection, auto-recovery, common failure modes, health checks
53
+
13.[Web Dashboard](./part12-web-dashboard.md) — **New.**`hermes dashboard`, the full browser UI — config, keys, sessions, logs, analytics, cron, skills, REST API, plugins
54
+
14.[Nous Tool Gateway](./part13-tool-gateway.md) — **New.** Web search, image gen, TTS, and browser automation through a single Nous Portal subscription
- A Linux/macOS machine (or WSL2 on Windows, or **Android via Termux** — see [Part 15](./part15-new-platforms.md#android--termux-running-hermes-on-your-phone))
56
88
- Python 3.11+ and Git
57
-
- An API key for at least one LLM provider (Anthropic, OpenAI, OpenRouter, etc.)
89
+
- An API key for at least one LLM provider (Anthropic, OpenAI, OpenRouter, Nous Portal, etc.)
58
90
- Optional: Ollama for local embeddings (free vector search)
91
+
- Optional: A paid [Nous Portal](https://portal.nousresearch.com) subscription to use the [Tool Gateway](./part13-tool-gateway.md) — web search, image gen, TTS, and browser automation with no extra keys
59
92
60
93
---
61
94
@@ -83,16 +116,21 @@ LLM Provider (Claude, GPT, local models)
>**Windows users:** Native Windows is not supported. Install [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) and run the command from inside WSL. It works perfectly.
120
158
159
+
>**Android users (new in v0.9):** the same installer detects Termux and installs the tested `[termux]` extra bundle automatically — CLI, cron, PTY/background terminal, Telegram gateway, MCP, Honcho, ACP. See [Part 15 — Android / Termux](./part15-new-platforms.md#android--termux-running-hermes-on-your-phone).
160
+
121
161
### What the Installer Does
122
162
123
163
The installer handles everything automatically:
@@ -156,15 +196,20 @@ Supported providers and recommended models:
156
196
157
197
| Provider | Top Models | Best For | Env Variable |
158
198
|----------|-----------|----------|-------------|
159
-
|**Anthropic**| Opus 4.6, Sonnet 4 | Best reasoning, complex tasks, coding |`ANTHROPIC_API_KEY`|
|**Xiaomi**| MiMo V2 Pro | Fast, cheap, great for orchestration and routing |`OPENROUTER_API_KEY`|
199
+
|**Nous Portal**| Hermes 5, Hermes 4 405B | Built-in [Tool Gateway](./part13-tool-gateway.md) — web search/image/TTS/browser with no extra keys | Auth via `hermes model`|
200
+
|**Anthropic**| Opus 4.6, Sonnet 4 | Best reasoning, complex tasks, coding, `/fast` priority tier |`ANTHROPIC_API_KEY`|
|**Hugging Face**| Any TGI/TEI endpoint | Self-hosted and Inference Endpoints |`HF_TOKEN`|
212
+
|**OpenRouter**| All of the above + 200 more | Access every model from one key, auto-fallback |`OPENROUTER_API_KEY`|
168
213
|**Ollama** (local) | Qwen 3.5 Opus Distilled V3, Gemma 4, Nemotron | Free, private, runs on your GPU — great for embeddings and simple tasks | None needed |
0 commit comments