Skip to content

Repository files navigation

Hermes Agent — Real-World Use Cases

Awesome Hermes Agent Use Cases

Awesome Use Cases Last Update Stars License

A community collection of real-world Hermes Agent use cases — each one backed by public evidence.

This Catalog Official Docs X Threads Reddit
Organized by category ✅ Partial ❌ ❌
Runnable demos included ✅ ❌ ❌ ❌
Primary source required ✅ ✅ ❌ ❌
Community-maintained ✅ ❌ ❌ ❌

Note

Evidence rule. Every use case here links to a primary source: an official Hermes doc, a Nous Research companion repo, a GitHub issue with deployment details, or a first-person blog post. If the only evidence is a tweet or "community build" marketing page, it lives in research/unverified.md instead — not in the catalog below.

Quick start

New to Hermes Agent? The fastest path:

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

Then pick a use case below. The /demos folder has three runnable starters: Daily Briefing, Open WebUI, and Team Telegram.

Categories

Automation & Scheduling

Name Description
Daily Briefing Bot A scheduled agent that researches topics every morning and delivers a summary to Telegram or Discord. The canonical "hello world" of Hermes automation.
Zero-Token Notifications Cron jobs that only wake the LLM when something actually changed — pre-filter with a Python script, only pay for tokens on meaningful signal.
Intent-to-Artifacts Workflow A personal workflow for turning rough prompts into runbooks, RSS curation, diagrams, and notes — delivered to Telegram + markdown files.
X Social Automation Toolset A native Hermes plugin for X/Twitter search, account reads, trend checks, and operator-approved actions through Xquik.
Inbox → Slack Daily Digest A weekday 9am cron that classifies your inbox and posts a needs-reply / FYI digest to a Slack channel. No auto-replies.
Sequenzy Email Marketing Agent Use Hermes with Sequenzy skills/CLI to draft lifecycle campaigns, manage subscriber workflows, send tests, and monitor email stats.
Microsoft Teams Meeting → Action Pipeline Ingest Microsoft Graph meeting events, prefer transcripts, fall back to recording plus STT, and deliver durable summaries to Teams, Notion, or Linear.
Self-Hosted Nextcloud Workspace Assistant Manage Nextcloud files, notes, calendars, tasks, and contacts from Hermes through WebDAV, CalDAV, CardDAV, and the Notes API.

Messaging & Team Bots

Name Description
Team Telegram Assistant Always-on shared bot for a small team — coding, research, ops — with per-user sessions, Docker-isolated terminal, and an allowlist. The gateway also supports Discord, Slack, WhatsApp, Signal, Matrix, Email, SMS, and more; the Telegram flow is the cleanest starting point for any of them.
Enterprise Messaging (Feishu / WeCom) Production-style Hermes deployments on Chinese enterprise chat platforms — Feishu managed under launchd, WeCom with native media-and-vision analysis.
Voice Assistant Workflows Three modes: CLI mic loop, voice notes in Telegram/Discord, and a Discord voice-channel bot. Same agent, same memory, voice-only I/O.
Hermes Live Voice A community voice gateway + Dashboard plugin that keeps a continuous, interruptible voice session open while durable Hermes /v1/runs execute in the background — bounded progress, steer/stop by task ID, completion notices after reconnect.

Coding & Developer Workflows

Name Description
GitHub PR Review (cron) Periodic PR review without opening a webhook endpoint. Authenticated gh, a review skill, and a cron job.
GitHub PR Review (webhook) Real-time PR comments via a signed GitHub webhook. End-to-end event-driven code review.
Production Software-Dev Workflow A field report of daily production development on Hermes — long sessions, delegation, memory, one 12-hour run with ~2.6M replay tokens.
Local Model Quantization with TurboQuant Optimize MLX models (Qwen3.5-9B) for local Apple Silicon inference using domain-specific skills — apply, benchmark, document, publish.
Hermes VS Code Workspace Stream A VS Code sidebar over Hermes ACP for streaming chat, tool output, editor context, attached files, model switching, and persistent workspace sessions.
Function-Calling Patterns The Hermes-Function-Calling companion repo as a pattern library — yfinance financial data, Pydantic JSON mode, GOAP scratch-pad planning, @tool registration, recursive multi-hop via --max_depth.

Frontends & UIs

Name Description
Open WebUI Frontend Point Open WebUI at the Hermes API server to get a full browser chat frontend for the agent, with session continuity.
TUI Operator Console Keyboard-first terminal HUD for managing your agent — live sessions, skills toggle, cron, logs, config editing, multiple themes.

Home & Device Control

Name Description
Home Assistant Control Conversational control of a smart home via four built-in HA tools — list entities, read state, call services.
Android Device Control Remote phone control from a Hermes chat — 36 android_* tools for taps, swipes, screenshots, and screen reading via a relay app.
Hermes iOS Native Engine A self-hosted iPhone companion with relay, connector, MCP sensor tools, voice, camera attachments, widgets, location, activity, and HealthKit context.
Personal AI Hub: Apple Health + Threads + Gmail + Calendar Desktop Hermes + Telegram Topics that wires Apple Health, Threads (via open-source skill), Gmail, and Google Calendar into a single chat surface with cross-domain queries.

Content & Creative Pipelines

Name Description
Autonovel — House of Bells End-to-end autonomous novel, art, and audiobook production. Nous Research's own pipeline shipped a 19-chapter, 79,456-word book with an audiobook and a website.
Printing-Factory Task Memory A custom skill that fixes long-context slowness and forgetting during daily factory operations. Local JSON index with sub-second retrieval.
Screen Recording → Tutorial Video Feed Hermes a raw screen recording and get a finished tutorial video on HeyGen with your AI avatar — script generation, video production, and memory of preferences for repeat work.
ComfyUI Workflow Orchestration Install, launch, and run ComfyUI node-based media generation workflows on demand — from Stable Diffusion to video pipelines, with automatic custom-node installation and deterministic output management.
AI Video Generation: HTML-to-MP4 Hermes writes designed HTML compositions (via Open Design), then renders to MP4 via HyperFrames — GSAP animations, shader transitions, TTS narration, all code-driven with no timeline editor.

Orchestration & Multi-Agent

Name Description
Paperclip Managed Employee Hermes running as a worker inside Nous Research's Paperclip task-orchestration system, with persistent sessions and checkpoints.
Self-Evolution A GEPA + DSPy loop that optimizes your Hermes skills, prompts, and tool text, producing PR-ready improvements for a few dollars per run.
Zouroboros Swarm Bridge Hermes as one of four interchangeable executors (Claude Code, Codex, Gemini, Hermes) inside a third-party multi-agent orchestrator. Bash-bridge adapter pattern with shared identity.
Matt Pocock Skills + Sub-Agents Use Matt Pocock's open-source skills (/grill-me, /to-prd, /to-issues) for planning and scoping, then Hermes sub-agents for parallel implementation of vertical-sliced issues — with HITL gates to stop AI slop before it ships.
Dynamic Skill Dojo A monitoring and improvement loop that reads session history, ranks weak skills, proposes patches or new skills, invokes self-evolution, and reports learning progress.
Hermes Kanban: Multi-Agent Swarm from Slack The v0.15 /kanban slash command turns a Slack message into a durable multi-agent swarm with named workers, a verifier, and a synthesizer — persistent via ~/.hermes/kanban.db.
Deterministic Workflow Delegation Hermes keeps the judgment, a deterministic runner keeps the receipts: repeatable jobs graduate from chat into checked .nika.yaml DAG files — audited before any token is spent, budget-capped, with tamper-evident run traces. Offline demo, zero keys.
Native A2A Agent Collaboration Discover and call specialist agents across machines or frameworks, or expose Hermes as an authenticated A2A service with streaming, audit logs, and anti-loop controls.
Per-Project Scoped Hermes Agents Ankh.md gives each project folder its own Hermes identity, config, skills, sessions, and memory while preserving the default global agent elsewhere.
Competing Autonomous AI Companies Run two Paperclip companies with Hermes workers against identical tasks, then compare execution evidence and transfer learned skills across teams.

Memory & Context

Name Description
YantrikDB Cognitive Memory (via MCP) Replace or augment native memory with a dedicated cognitive DB — vector + knowledge graph + temporal decay + contradiction detection. Integrates over MCP, so no Hermes plugin needed.
Obsidian Vault as a Second Brain Wire Hermes into an Obsidian vault for persistent knowledge — read notes, create daily dashboards, cross-reference tags, maintain a self-improving personal knowledge base.
Hermes Memory OS A seven-layer local memory stack with session search, trusted facts, hybrid vector retrieval, automatic extraction, a self-curating wiki, and ground-truth rules.
Quantified-Self Life OS Track personal routines and wellness signals, detect evidence-bounded correlations, and deliver scheduled morning, evening, and weekly reflections.

Observability & Operations

Name Description
Hermes Labyrinth Observability A read-only dashboard plugin that turns prompts, tool calls, failures, approvals, model switches, cron runs, and memory hits into auditable agent journeys.
Deterministic Record and Replay of Hermes Runs Records a run at the process and socket boundary, replays it offline byte for byte with the network off, and forks it from any checkpoint onto a different model. Needs no plugin and no change to config.yaml.
Autonomous SRE Incident Commander Detect, triage, diagnose, safely remediate, verify, document, and learn from Linux, Docker, or Kubernetes incidents.
Local API Trace Debugging Run Hermes through claude-tap to inspect provider requests, prompts, tools, streaming responses, token usage, and request diffs in a local viewer.

Security & Assurance

Name Description
Autonomous Penetration Testing with Kali A Kali-backed Hermes skill for authorized security assessments with scope confirmation, playbooks, zero-findings fallback, approval gates, and structured reports.
Sandboxed Hermes with NVIDIA OpenShell Run Hermes behind out-of-process network, filesystem, syscall, and inference policies while retaining approved memory, skills, cron, and gateway capabilities.

Finance & Trading

Name Description
Weather Trading on Polymarket Autonomous weather prediction-market trading — Kelly Criterion position sizing, EV scoring against market odds, self-calibrating with real traders reporting $300→$123K in 3 months on a $5 VPS.
ERPClaw: Plain-English ERP and Accounting Self-hosted double-entry ERP and accounting run from chat. Invoicing, inventory, payroll, and multi-company books, written to a local database by deterministic skill actions.
First-Dollar Business Guidance Hermes Startup: a local-first skill that turns your personal profile into 3 of 10 evidence-labeled ideas, one bounded next action, and a prepaid per-call tool balance — no subscription, no income guarantee.

Deployment Patterns

Name Description
Hermes on Fly.io Official Fly-apps deployment guide — run Hermes as a Fly Machine with a volume-backed /opt/data, daily snapshots, and ~$15/month baseline.
Local & Proxy Model Backends Run Hermes against Ollama, vLLM, oMLX, or a custom OpenAI-compatible proxy — for cost control, data locality, or model choice beyond the defaults.
Local Model Auto-Detection Hermes probes your local inference server, identifies the running model, detects context window, and auto-configures — eliminates first-setup friction for Ollama, llama.cpp, MLX, and vLLM.
Headless Daemon Server A self-managed Linux VPS pattern that runs Hermes gateway and native cron under systemd with a dedicated service user and reboot-safe scheduling.
Hermes + Browser Harness on Hostinger A 10-minute copy-paste script (54★ gist) that wires Browser Use's Browser Harness as a Hermes skill on a consumer VPS — symlinked skill, OpenRouter, Browser Use Cloud free tier.
scicco/hermzner: Hardened Hermes on Hetzner Terraform + Ansible setup for a Hetzner VPS with rootless Podman, Tailscale-only network, UFW default-deny, read-only root FS, and pinned image digests. Production-grade, nascent (3★).
Enterprise Cloud (Bedrock / Azure AI Foundry / NVIDIA Build) First-class provider IDs for the three major enterprise model gateways — Bedrock Converse API + Guardrails, Azure Foundry endpoint, NVIDIA NIM cloud or self-hosted. For regulated / procurement-constrained shops.
China-Region LLM Endpoints Dedicated China-facing provider IDs for Kimi/Moonshot, MiniMax, and z.ai/GLM — auto-probing endpoints, no hand-wired base URLs. Pair with Feishu/WeCom for a fully domestic stack.
Nous Portal Gateway The maintainers' recommended default — one OAuth login unlocks 300+ models plus a Tool Gateway (web search, image gen, TTS, browser) and Nous Chat. Scoped JWTs, no per-provider key juggling.
Coding-Tool Subscriptions as Backends (Copilot / Codex / Claude Max) Reuse existing coding-tool subscriptions as Hermes model backends — Copilot direct + ACP, Codex device-code OAuth, Claude Max extra-usage OAuth — with native auth and 401 one-shot recovery.
Integrated Self-Hosted Hermes Stack Bootstrap Hermes with model routing, local inference, search, vector memory, automation, notifications, observability, and monitoring through a tiered Docker stack.
Persistent Hermes on Hugging Face Spaces Deploy Hermes as a Space with a web dashboard and messaging gateway, synchronizing durable agent state to a private Hugging Face Dataset.

Research & Training

Name Description
Multi-Platform Social Media Research Run a single query across Reddit, X/Twitter, YouTube, Hacker News, and Polymarket via a single Python engine. Firefox-cookie auth for X, no API key needed on WSL. Delivered as a unified markdown brief to Telegram or local storage.
RL Training & Benchmarks Use Hermes environments to train and evaluate tool-calling models. The TBLite benchmark covers 100 tasks with strong correlation to TB2.
ClawBench Browser-Agent Evaluation Run Hermes against isolated live-web tasks with native browser tools over CDP, interception-based scoring, and five-layer traces for debugging.
Browser & Admin UIs The official web dashboard plus community UIs — browser access to sessions, files, cron, and control plane.

Runnable demos

Three starter demos live in /demos. Each has a README.md, a .env.example, and a one-command setup:

  • daily-briefing — cron + web search + Telegram delivery
  • matt-pocock-skills — planning pipeline (/grill-with-docs → /to-issues) + verification script demo
  • openwebui — Hermes API server + Open WebUI via Docker Compose
  • team-telegram — gateway + Telegram + Docker terminal backend

Contributing

See CONTRIBUTING.md. The short version: one primary source minimum — official docs, a Nous companion repo, a GitHub issue with real deployment detail, or a first-person blog post. X posts and "community build" marketing pages don't count as primary evidence.

For Contributors

Every PR that touches usecases/*.md triggers automated verification. Learn how it works and how to pass it:

  • docs/verification-criteria.md — how scoring works, what's green vs yellow vs red, and how to run the script locally before submitting
  • python scripts/verify-usecase.py --usecase usecases/my-topic.md --check all — generate your own verification report

Please only submit use cases you have personally run (at least once) or that you can trace to a primary public source. No crypto use cases.

License

MIT for code and configs. Docs and diagrams under CC BY 4.0.

Acknowledgements

Catalog format inspired by awesome-openclaw-usecases. Hermes Agent is built by Nous Research.

About

Curated real-world use cases for Hermes Agent — the self-improving AI agent from Nous Research. Backed by primary sources.

Topics

Resources

Contributing

Stars

243 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages