Skip to content

aliaihub/awesome-hermes-usecases

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.
Sequenzy Email Marketing Agent Use Hermes with Sequenzy skills/CLI to draft lifecycle campaigns, manage subscriber workflows, send tests, and monitor email stats.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.
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.

Releases

No releases published

Packages

 
 
 

Contributors

Languages