Skip to content

Summoning Ritual

To bind the Daemon to the Host, you must complete the four stages of the Rite.

I. The Desecration

Prepare the Unholy Grounds. The Order of the Iron Covenant mandates the use of uv for its speed and hermetic isolation, though legacy pip invocations are tolerated.

  • The Iron Path (Recommended) Clean, isolated, and instant.
uv tool install lychd
  • The Acolyte's Path (Legacy) Standard pip installation.
pip install lychd
  • The Necromancer's Path (Source) For Magi seeking to modify the core.
git clone https://github.com/hexanomicon/lychd.git
cd lychd
uv sync

II. The Inscription

Before the Lich can rise, you must tell it where the bodies are buried. Initialize the Codex to spawn the configuration templates and forge the Crypt.

lychd init

This establishes the Sacred Grounds:

  • 📜 The Codex (~/.config/lychd): The book of Runes (Quadlets & Blueprints).
  • 🪦 The Crypt (~/.local/share/lychd): The persistent storage.
    • Note: The Scribe will inspect your filesystem. If Btrfs is not detected, it will automatically forge a Loopback Mirror to support Autopoiesis.

> Action Required: Enter the Codex and configure your power sources.

  • Set your model_root in lychd.toml.
  • Define your Soulstones (Local LLMs) or Portals (Cloud APIs) in soulstones/ and portals/.

III. The Transmutation

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.

IV. The Summoning

Invoke the Vessel. The Sepulcher manages the start of required services.

systemctl --user start lychd

# Use this command to hear the internal monologue of the Scribe
journalctl --user -fu lychd

*> "The summoning is complete."*