Hermes Agent Configuration
My Hermes Agent config, persona, skills, and scripts. Clone this to rebuild a Hermes agent instance on a fresh machine.
What's tracked
| Path | Purpose | Critical? |
|---|---|---|
config.yaml |
Model provider, toolsets, feature toggles | ✅ |
SOUL.md |
Persona definition (tone, values, boundaries) | ✅ |
memories/ |
Built-in memory (always-in-context facts) | ✅ |
skills/ |
Installed skills (agent workflows + knowledge) | ✅ |
scripts/ |
Custom automation scripts | ✅ |
cron/jobs.json |
Scheduled job definitions | ✅ |
kanban.db |
Multi-agent board state | ⬜ |
reading_*.json |
Reading list and state | ⬜ |
channel_directory.json |
Gateway platform routing | ⬜ |
Restoration steps
On a fresh machine:
# 1. Install Hermes Agent
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 2. Clone this repo over the top
cd ~/.hermes
git init
git remote add origin https://gitea.conlon.fun/andy/hermes-config.git
git pull origin main
# 3. Restore secrets (from your safe backup)
# Copy ~/.hermes/.env and ~/.hermes/auth.json back in place
# .env needs: OPENROUTER_API_KEY, MATRIX_ACCESS_TOKEN (if using Matrix)
# auth.json holds OAuth tokens for various providers
# 4. Restore SQLite databases (optional — from backup snapshots)
# ~/.hermes/backups/ holds daily snapshots of:
# - memory_store.db (holographic long-term memory)
# - state.db (session history / recall)
# 5. Let Hermes pick up your skills
hermes skills list # verify skills are loaded
hermes skills reload # if any are missing
# 6. Re-enable cron jobs
hermes cron list # verify jobs
# Cron definitions are in cron/jobs.json and auto-load
# 7. Start gateway if needed
hermes gateway run # or hermes gateway install for persistent service
What you'll need to set up manually
These are not in this repo (secrets):
| File | What it holds |
|---|---|
~/.hermes/.env |
OPENROUTER_API_KEY, MATRIX_ACCESS_TOKEN, other API keys |
~/.hermes/auth.json |
OAuth tokens (Spotify, GitHub Copilot, etc.) |
Snapshot backups
A cron job runs daily and copies memory_store.db and state.db to ~/.hermes/backups/ with timestamps. These capture accumulated memory and session history.