Gormes

§ 01 · OPEN SOURCE · MIT LICENSE

One Go Binary. Same Hermes Brain.

A static Go binary that talks to your Hermes backend over HTTP. scp it to Termux, Alpine, a fresh VPS — Gormes adds no runtime of its own on top of what Hermes already needs.

Install View Source

1. INSTALL

curl -fsSL https://gormes.ai/install.sh | sh

2. RUN

gormes

Requires Hermes backend at localhost:8642. Install Hermes →

§ 02 · FEATURES

Why a Go layer matters.

Single Static Binary

Zero CGO. ~17 MB. scp it to Termux, Alpine, a fresh VPS — it runs.

Boots Like a Tool

No Python warmup. 16 ms render mailbox keeps the TUI responsive under load.

In-Process Tool Loop

Streamed tool_calls execute against a Go-native registry. No bounce through Python.

Survives Dropped Streams

Route-B reconnect treats SSE drops as a resilience problem, not a happy-path omission.

§ 03 · SHIPPING STATE

What ships now, what doesn't.

SHIPPED · EVOLVING

Phase 1 — Dashboard

  • Bubble Tea TUI shell
  • Kernel with 16 ms render mailbox (coalescing)
  • Route-B SSE reconnect — dropped streams recover
  • Wire Doctor — offline tool-registry validation
  • Streaming token renderer
  • Ongoing: polish, bug fixes, TUI ergonomics
IN PROGRESS · 3/7

Phase 2 — Gateway

  • 2.A Go-native tool registry + kernel tool loop
  • 2.B.1 Telegram adapter
  • 2.C Thin session persistence (bbolt)
  • 2.B.2+ Wider platforms (23 upstream connectors queued)
  • 2.D Cron / scheduled automations
  • 2.E Subagent delegation
  • 2.F Hooks + lifecycle
IN PROGRESS · 4/5

Phase 3 — Memory

  • 3.A SQLite + FTS5 lattice
  • 3.B Ontological graph + LLM extractor
  • 3.C Neural recall + context injection
  • 3.D.5 USER.md mirror — Gormes-original, no upstream equivalent
  • 3.D Ollama embeddings + semantic fusion
PLANNED · 0/8

Phase 4 — Brain Transplant

Ships hermes-off after 4.A–4.D. Backend becomes optional.

  • 4.A Provider adapters (Anthropic, Bedrock, Gemini, OpenRouter, Google Code Assist, Codex, xAI)
  • 4.B Context engine + compression
  • 4.C Native Go prompt builder
  • 4.D Smart model routing
  • 4.E Trajectory + insights
  • 4.F Title generation
  • 4.G Credentials + OAuth flows
  • 4.H Rate / retry / prompt caching
LATER · 0/16

Phase 5 — Final Purge (100% Go)

Delete the last Python dependency. Ship entirely in Go.

  • 5.A–5.P — tool surface, sandboxing, browser, vision, voice, skills, MCP, ACP, plugins, security, code exec, file ops, CLI, packaging. See ARCH_PLAN §7.