hermes-example-plugins

Reference plugins for hermes-agent — small, focused examples that show how a single plugin surface works, end to end.

These are not bundled with hermes-agent. The core repo ships only the plugins users actually run (memory providers, the disk-cleanup hook, platform adapters). Reference plugins live here so plugin authors can read them, copy them, install them as user plugins, and ignore them otherwise.

Index

Plugin	Surface	Demonstrates
plugin-llm-example	ctx.llm.complete_structured()	Host-owned structured LLM calls — typed text/image input, JSON Schema validation, trust-gate config
plugin-llm-async-example	ctx.llm.acomplete() + asyncio.gather()	Async LLM lane — concurrent forward + sentiment + back-translation pass for /translate
example-dashboard	dashboard/manifest.json	Bare-minimum dashboard plugin — a tab, a slot injection, a backend route
strike-freedom-cockpit	dashboard theme + slot plugin	Complete custom-skin reskin — palette, layout variant, asset slots, sidebar HUD

Installing an example as a user plugin

Each directory is a self-contained plugin. To run one in your own Hermes Agent setup:

git clone https://github.com/NousResearch/hermes-example-plugins.git

# pick whichever you want
cp -r hermes-example-plugins/plugin-llm-example       ~/.hermes/plugins/
cp -r hermes-example-plugins/plugin-llm-async-example ~/.hermes/plugins/
cp -r hermes-example-plugins/example-dashboard        ~/.hermes/plugins/
cp -r hermes-example-plugins/strike-freedom-cockpit   ~/.hermes/plugins/

# enable any with a slash command surface
hermes plugins enable plugin-llm-example
hermes plugins enable plugin-llm-async-example

For dashboard plugins, restart the web UI (or GET /api/dashboard/plugins/rescan) to pick up the new tab. To uninstall, rm -rf ~/.hermes/plugins/<name> and the corresponding rescan / hermes plugins disable.

Reading order for plugin authors

The plugins here are deliberately minimal — each one shows one plugin surface in the smallest amount of code that demonstrates it. Companion docs for each surface live in the main hermes-agent docs site under Developer Guide → Extending.

Pair each plugin in this repo with its docs page:

Plugin here	Docs page
plugin-llm-example	Plugin LLM Access
plugin-llm-async-example	Plugin LLM Access
example-dashboard	Extending the Dashboard
strike-freedom-cockpit	Extending the Dashboard

Contributing a new example

Reference plugins should be:

• Self-contained. No deps beyond hermes-agent itself unless absolutely required.
• Single-surface. One plugin, one ctx.* API. If your example needs three ctx.register_* calls to make sense, it's probably not a reference example — it's a real plugin.
• Under ~200 LOC of plugin code. Reference plugins compete for attention with reading the docs page. Keep them small.
• Production-shaped. Use real types, real error handling, real audit logging — show plugin authors what we'd want them to write, not a stripped-down demo.

PRs welcome. Open an issue first if the surface you want to demonstrate isn't already covered in the hermes-agent developer-guide docs — we may want to write the docs page first, then add a companion reference plugin here.

License

MIT, same as hermes-agent.