hermes-self-evolution

What hermes-self-evolution does

The framework runs four scheduled Hermes cron jobs that cooperate offline, while the user is away. Evolution turns friction recorded in an append-only witness log into capability updates, Critic reviews that work, Verifier prints predictions to check later, and Gardener scans for dormant skills. A constitution.md with six articles binds the loop: amendments are proposal-only and need human approval, and every cycle must produce a real report even when nothing changes.

The README names three failure modes it targets. Bookkeeping theatre is when cycles produce internal cleanups with no visible improvement. Collusion happens when Evolution and Critic run the same model, which a diverse-model setup avoids. The skill loader caveat is that skills=[...] on cron create has failed with qualified-name lookups in some Hermes setups, so the prompts load skills at runtime through read_file and terminal. The framework complements Hermes' built-in in-session learning loop rather than replacing it. The repository ships prompts, three shell scripts, an install.sh and empty templates that each operator populates with their own experience.

Key features

• Four scheduled cron jobs: Evolution, Critic, Verifier and Gardener
• Six-article constitution with proposal-only amendments and mandatory human approval
• Append-only witness log as ground truth, and a required report from every cycle
• Dormant-skill scanner and prediction printer implemented as shell scripts
• Ships empty: no preset friction database or cron history
• Prompts load skills at runtime through read_file and terminal for portability

When to use it

• Auditing a long-running Hermes instance for recurring friction while you are away
• Running the critic on a different model from the one that proposes changes
• Keeping self-improvement changes under a written governance protocol

Who it is for: Hermes Agent operators who want scheduled, governed self-improvement on top of the built-in learning loop.

How it fits with Hermes Agent

Built for Hermes Agent: it runs on Hermes cron jobs and is designed to complement Hermes' built-in learning loop, which works in-session.

FAQ