Profile Distributions: Share a Whole Agent
Profile Distributions: Share a Whole Agent A profile distribution packages a complete Hermes agent — personality, skills, cron jobs, MCP connections, config — a
A profile distribution packages a complete Hermes agent — personality, skills, cron jobs, MCP connections, config — as a git repository. Anyone with access to the repo can install the whole agent with one command, update it in place, and keep their own memories, sessions, and API keys untouched. …
What this page covers
- What this means
- Why git?
- When should you use a distribution?
- The lifecycle: author to installer to update
- For authors: publishing a distribution
- Step 1 — Start from a working profile
- Step 2 — Add a distribution.yaml
- Step 3 — Push to a git repo
- Step 4 — Tag versioned releases
- What the repo looks like
- Distribution-owned vs user-owned
- For installers: using a distribution
- Install
- Source types
- Override the profile name
- Fill in env vars
- Check what you installed
- Update
- Remove
- Use cases and patterns
- Personal: sync one agent across machines
- Team: ship a reviewed internal agent
- Community: publish a public agent
- Product: ship an opinionated agent
- Ephemeral: one-off scripts on shared infra
- Recipes
- Pin to a specific version
- Check what version you're on vs. latest
- Keep local config customizations through updates
- Force a clean re-install
- Fork and customize
- Test a distribution before pushing
- What's NOT in a distribution (ever)
- Security and trust
- Under the hood
- See also
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Using Hermes
CLI Interface
Hermes Agent's CLI is a full terminal user interface (TUI) — not a web UI. It features multiline editing, slash command autocomplete, conversation history, inte
TUI
The TUI is the modern front end for Hermes — a terminal UI backed by the same Python runtime as the Classic CLI. Same agent, same sessions, same slash commands;
Configuration
All settings are stored in the directory for easy access. TIP — Easiest path to a working Run — one OAuth gets you a model provider and all four Tool Gateway to
Configuring Models
Configuring Models Hermes uses two kinds of model slots: Main model — what the agent thinks with. Every user message, every tool call loop, every streamed respo
Sessions
Hermes Agent automatically saves every conversation as a session. Sessions enable conversation resume, cross session search, and full conversation history manag
Profiles: Running Multiple Agents
Profiles: Running Multiple Agents Run multiple independent Hermes agents on the same machine — each with its own config, API keys, memory, sessions, skills, and