Hermes Plugin Generator 🔌

Scaffold, extend, and bundle Hermes Agent plugins from natural language descriptions.
Describe what you want — it generates the full plugin structure with plugin.yaml, __init__.py, schemas.py, tools.py, and optional bundled skill.

Features

plugin_scaffold — Create a complete plugin from a description. Generates production-quality code with proper check_fn, emoji, kind: standalone, and PEP-8-compliant Python.
plugin_add_tool — Add a new tool to an existing plugin. Updates schemas, handlers, registration, and YAML manifest.
plugin_add_skill — Bundle a skill with an existing plugin. Creates skill directory, registers it in __init__.py, and updates plugin.yaml.
Plays well with Hermes — Generated code matches the official Hermes plugin conventions.
Zero dependencies — pure Python 3.11+ stdlib. Works on Windows, Linux, macOS.

Quick Start

# Clone and install
git clone https://github.com/iruzen-dono/hermes-plugin-gen.git
cp -r hermes-plugin-gen ~/.hermes/plugins/hermes-plugin-gen

# Enable
hermes plugins enable hermes-plugin-gen

# Restart Hermes / start new session

Then ask the agent:

"Create a plugin called 'joke-teller' with a 'tell_joke' tool"

Or use it directly:

from hermes_tools import plugin_scaffold

result = plugin_scaffold({
    "name": "weather-alert",
    "description": "Weather alert plugin with SMS notifications",
    "tools": [
        {"name": "check_weather", "description": "Check current conditions", ...},
        {"name": "send_alert", "description": "Send weather alert via SMS", ...}
    ],
    "requires_env": [{"name": "WEATHER_API_KEY", "description": "Weather API key"}],
    "with_skill": True
})

Generated Structure

~/.hermes/plugins/your-plugin/
├── plugin.yaml         # Manifest with kind, requires_env, provides_tools
├── __init__.py          # register(ctx) with check_fn, emoji, description
├── schemas.py           # LLM tool schemas
├── tools.py             # handlers + check_requirements()
└── skills/your-plugin/
    └── SKILL.md         # Bundled skill (optional)

Installation

As a plugin (recommended for agents):

cp -r hermes-plugin-gen ~/.hermes/plugins/hermes-plugin-gen
hermes plugins enable hermes-plugin-gen

As standalone scripts (for CLI use):

# The tools.py can be imported directly in scripts
python -c "from hermes_plugin_gen.tools import plugin_scaffold; ..."

Requirements

Hermes Agent (any profile)
Python 3.11+

Documentation

Bundled skill at skills/hermes-plugin-gen/SKILL.md — load it in-session with load skill hermes-plugin-gen.

Contributing

PRs welcome! The generated code must always pass PIP 8, include proper error handling, and match official Hermes conventions.

License

MIT

hermes-plugin-gen

What it adds

Tools 3

README