Building Gormes

Contributor-facing documentation. If you’re reading because you want to use Gormes, start at Using Gormes.

Gormes in one sentence

Gormes is the production runtime for self-improving agents. Four core systems live inside the binary:

1. Learning Loop — detect complex tasks, distill reusable skills, improve them over time (Phase 6)
2. Memory — SQLite + FTS5 + ontological graph, with a human-readable USER.md mirror (Phase 3)
3. Tool Execution — typed Go interfaces, in-process registry, no Python bounce (Phase 2.A)
4. Gateway — one runtime, many interfaces: TUI, Telegram, (future) Discord/Slack (Phase 2.B)

Contents

• Core Systems — one page per system, how they work today
• What Hermes Gets Wrong — the opportunities that justify Gormes’s existence
• Architecture Plan — full roadmap, phase-by-phase, with subsystem inventory
• Porting a Subsystem — the contribution path: pick from §7, write spec + plan, open PR
• Testing — Go test suite, Playwright smoke, Hugo build rig

In this section

• Architecture Plan
• Core Systems
• What Hermes Gets Wrong
• Porting a Subsystem from Upstream
• Testing