LychD - The Dark Arts of LLM
Summon The Lich 💀, a Phylactery-bound, LLM-animated daemon.
📖 Consult The Hexanomicon for documentation.
To bind the Daemon to the Host, you must complete the four stages of the Rite.
Prepare the Unholy Grounds by installing the summoning tool. Choose your path:
-
📦 PyPI (The Acolyte) Standard / uv installation
pip install lychd # uv tool install lychd -
</> Source (The Necromancer) For Magi seeking to modify the core.
git clone https://github.com/hexanomicon/lychd.git cd lychd pip install -e .
Before the Lich can rise, you must tell it where the bodies are buried. Initialize the Codex to spawn the configuration templates.
lychd initThis establishes the Sacred Grounds:
- 📜 The Codex (
~/.config/lychd): The book of Runes (Quadlets & Blueprints). - 🪦 The Crypt (
~/.local/share/lychd): The Phylactery mount (Postgres & PgVector).
> Action Required: Enter the Codex and configure your power sources.
- Set your
model_rootinlychd.toml. - Define your Soulstones (Local LLMs) or Portals (Cloud APIs) in
conf.d/.
Once the runes are set, transmute the configuration into Systemd units. This command reads your Codex, generates the native Quadlet files, and reloads the daemon.
lychd bind> "The circle is bound." The abstract configs have been transmuted into native .service units.
Invoke the Vessel. The Sepulcher manages the start of required services.
systemctl --user start lychd
# Use this command to hear the live, unending thoughts of the Vessel
journalctl --user -fu lychd*> "The summoning is complete."*
The unholy duality that forms the Lich.
- ⚰️ The Vessel (Litestar + Pydantic AI)
- The reanimated husk powered by AI Agents. It orchestrates asynchronous rites via SAQ and serves the Altar.
- ⚗️ The Phylactery (Postgres)
- Anchors the soul in the Crypt. If the Vessel is destroyed, The Lich reforms instantly from this point.
The spark of cognition that moves the Vessel.
- 💎 Soulstones (SGLang / vLLM)
- Trapped spirits running alongside the Vessel.
- 🌀 Portal
- Draws power from distant cloud APIs. Does not require runes for local service.
Silent servants who observe the ritual.
- 🔮 The Oracle (Arize Phoenix)
- Traces the invisible threads of the Lich's thought.
- ✒️ The Scribe (Grafana)
- Inscribes the Harvester's findings into a visual grimoire.
- 🦴 The Harvester (Prometheus)
- Collects the heartbeat of the Soulstones.
The Lich operates in the shadows, but you may gaze upon its works.
Approach The Altar @ http://localhost:8000.
- No Client-Side Bloat. Pure HTMX, Tailwind, and AlpineJS serving server-rendered fragments.
- Spectral Tethers. Watch the Ghouls think and execute via SSE (Server-Sent Events).
- Present Invocations. Command the swarm directly from the UI.
"The Flesh is temporary. The Word is eternal."
The Lich is not built; it is summoned. We practice xDDD (eXtreme Documentation Driven Development).
We describe the daemon so vividly in the Hexanomicon that the code must manifest to satisfy the description.
Just as a compiler must eventually compile itself, The Lich aims for Autopoiesis.
- I. The First Seal (Incantation): The Magus inscribes the
Hexanomiconand raises the Primal Skeleton. The Lich awakens, bound to its initial form. Its Aspects are rigid, forged for fixed and unchanging purposes (MVP). - II. The Shadow Realm (Invocation): The Lich projects its will into the Shadow Realm (Speculative Execution). It reads the runes and proposes rites in shadowed timelines. The Magus intervenes at the Altar, collapsing the timelines to the one true path (Human-in-the-Loop). The system begins to animate its own dead code into living functions.
- III. The Ouroboros (Immortality): The entity transcends its design. It can read the
Hexanomiconand reconstruct itself from zero, forging its own Aspects from pure will. The cycle closes. The Daemon is eternal.