Hermes FleetManager Plugin

What Hermes FleetManager Plugin does

The runtime chain starts when a client such as Telegram creates an intent and queues tasks. FleetManager reads pending tasks from PostgreSQL and dispatches the matching agent from .github/agents/code/. Orchestration helpers assemble redacted context before any LLM fallback path, and Hermes keeps provider selection in its normal config flow, including OpenRouter and user-defined providers. Queued task payloads preserve provider, model, base_url and api_mode so downstream agents respect the caller's choice.

The plugin exposes three tools: fleetmanager_status returns pending task count, visible tasks and available agents, fleetmanager_run runs the orchestration once, and fleetmanager_agents lists installed code agents. The installer symlinks the plugin into ~/.hermes/plugins, copies the agent assets, installs Python dependencies, can install PostgreSQL on Debian or Ubuntu, and writes database settings to ~/.hermes/.env. You then enable it with plugins.fleetmanager.enabled in the Hermes config.

Key features

• PostgreSQL task queue with intent decomposition
• Dispatch to agents from .github/agents/code
• Redacted context assembly before LLM fallback
• Provider, model, base_url and api_mode kept in queued payloads
• Tools fleetmanager_status, fleetmanager_run and fleetmanager_agents
• Test suite with ruff, black, mypy, pyright and pytest

When to use it

• Queuing tasks from Telegram and letting specialized agents pick them up
• Checking pending work and available agents from inside Hermes
• Forcing a provider such as OpenRouter for a particular caller

Who it is for: Hermes Agent users who want a database-backed queue and a fleet of task-specific agents.

How it fits with Hermes Agent

It is a Hermes plugin enabled through the plugins section of the Hermes config and installed into ~/.hermes/plugins.

How to install Hermes FleetManager Plugin

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

bash install.sh

Requirements: PostgreSQL (the installer can install it on Debian or Ubuntu) and the Python dependencies in requirements.txt

Note: The installer creates a PostgreSQL database with default credentials and edits ~/.hermes/config.yaml to use OpenRouter with a free Nemotron model.

FAQ