diff --git a/docs/integrations/hermes.mdx b/docs/integrations/hermes.mdx
index 99dda32f4..c98309bf2 100644
--- a/docs/integrations/hermes.mdx
+++ b/docs/integrations/hermes.mdx
@@ -2,116 +2,185 @@
title: Hermes Agent
---
-Hermes Agent is a self-improving AI agent built by Nous Research. It features automatic skill creation, cross-session memory, and 70+ skills that it ships with by default.
+[Hermes Agent](https://hermes-agent.nousresearch.com) is an assistant from Nous Research with memory, skills, subagents, tools, and messaging gateways.
-
+## Get started
-## Quick start
+Launch Hermes with Ollama:
-```bash
+```shell
ollama launch hermes
```
-Ollama handles everything automatically:
+If Hermes is not installed, Ollama prompts to install it. Ollama configures the Ollama provider, sets your selected model as the default, and opens Hermes chat.
-1. **Install** — If Hermes isn't installed, Ollama prompts to install it via the Nous Research install script
-2. **Model** — Pick a model from the selector (local or cloud)
-3. **Onboarding** — Ollama configures the Ollama provider, points Hermes at `http://127.0.0.1:11434/v1`, and sets your model as the primary
-4. **Gateway** — Optionally connects a messaging platform (Telegram, Discord, Slack, WhatsApp, Signal, Email) and launches the Hermes chat
+## Capabilities
-## Recommended models
+
+
+
+
+
+
Chat
+
Ask questions about a repository or task
+
+
+
+
+
+
Command line
+
Run commands with Hermes
+
+
+
+
+
+
Tool calling
+
Use tools with compatible models
+
+
+
+
+
+
File edits
+
Read and edit files in your project
+
+
+
+
+
+
Subagents
+
Split work across tasks
+
+
+
+
+
+
Web fetch
+
Fetch and summarize web pages
+
+
+
+
+
+
Vision
+
Send images and screenshots
+
+
+
+
+
+
Thinking
+
Use thinking controls with compatible models
+
+
+
+
-**Cloud models**:
+## Models
-- `kimi-k2.5:cloud` — Multimodal reasoning with subagents
-- `glm-5.1:cloud` — Reasoning and code generation
-- `qwen3.5:cloud` — Reasoning, coding, and agentic tool use with vision
-- `minimax-m2.7:cloud` — Fast, efficient coding and real-world productivity
+Choose a local or cloud model from Ollama when launching Hermes.
-**Local models:**
+
+
+ Use larger models hosted by Ollama.
+
+
+ Run models on your own machine.
+
+
-- `gemma4` — Reasoning and code generation locally (~16 GB VRAM)
-- `qwen3.6` — Reasoning, coding, and visual understanding locally (~24 GB VRAM)
+Run Hermes with a model directly:
-More models at [ollama.com/search](https://ollama.com/search?c=cloud).
+```shell
+ollama launch hermes --model gemma4:cloud
+```
-## Connect messaging apps
+## Messaging apps
-Link Telegram, Discord, Slack, WhatsApp, Signal, or Email to chat with your models from anywhere:
+On first interactive launch, Ollama asks whether you want to connect a messaging app.
-```bash
+Connect one later with Hermes:
+
+```shell
hermes gateway setup
```
-## Reconfigure
+Hermes supports Telegram, Discord, Slack, WhatsApp, Signal, Email, and more.
-Re-run the full setup wizard at any time:
+## Run without interaction
-```bash
-hermes setup
+Use `--yes` with a model for scripts and repeatable setups:
+
+```shell
+ollama launch hermes --model gemma4:cloud --yes
```
## Manual setup
-If you'd rather drive Hermes's own wizard instead of `ollama launch hermes`, install it directly:
+
+
Hermes launches the setup wizard automatically. Choose **Quick setup**:
-```
+```text
How would you like to set up Hermes?
→ Quick setup — provider, model & messaging (recommended)
Full setup — configure everything
```
-### Connect to Ollama
+
3. Configure Ollama
-1. Select **More providers...**
-2. Select **Custom endpoint (enter URL manually)**
-3. Set the API base URL to the Ollama OpenAI-compatible endpoint:
+- Select **More providers...**
+- Select **Custom endpoint (enter URL manually)**
+- Set the API base URL to the Ollama OpenAI-compatible endpoint:
- ```
- API base URL [e.g. https://api.example.com/v1]: http://127.0.0.1:11434/v1
- ```
-
-4. Leave the API key blank (not required for local Ollama):
-
- ```
- API key [optional]:
- ```
-
-5. Hermes auto-detects downloaded models, confirm the one you want:
-
- ```
- Verified endpoint via http://127.0.0.1:11434/v1/models (1 model(s) visible)
- Detected model: kimi-k2.5:cloud
- Use this model? [Y/n]:
- ```
-
-6. Leave context length blank to auto-detect:
-
- ```
- Context length in tokens [leave blank for auto-detect]:
- ```
-
-### Connect messaging
-
-Optionally connect a messaging platform during setup:
-
-```
-Connect a messaging platform? (Telegram, Discord, etc.)
-
- → Set up messaging now (recommended)
- Skip — set up later with 'hermes setup gateway'
+```text
+API base URL [e.g. https://api.example.com/v1]: http://127.0.0.1:11434/v1
```
-### Launch
+- Leave the API key blank. It is not required for local Ollama.
-```
-Launch hermes chat now? [Y/n]: Y
+```text
+API key [optional]:
```
+- Confirm the model Hermes detects:
+
+```text
+Verified endpoint via http://127.0.0.1:11434/v1/models (1 model(s) visible)
+ Detected model: kimi-k2.5:cloud
+ Use this model? [Y/n]:
+```
+
+- Leave context length blank to auto-detect:
+
+```text
+Context length in tokens [leave blank for auto-detect]:
+```
+
+