LychD - The Dark Arts of LLMs

Summon The Lich 💀 — a linux-native daemon that manages agents through:

• 🔥 Dynamic Services — Hot-swap models and engines on the fly via systemd. Orchestrate your hardware through Covens to switch from fast VRAM workers to massive CPU-offloaded models for specialized tasks.
• 🧠 Atomic Persistence — The spirit arises from the data. Code and memory are bound in atomic snapshots (Btrfs/Git/Postgres) within the Phylactery, enabling perfect reanimation and instant rollback.
• 🔒 Sandboxed Security — Double-rootless Podman isolation. The Vessel reasons in one cage while dangerous tools execute in a second, kernel-hardened sandbox (Landlock) with strictly limited mounts.
• 🌀 Speculative Execution — Explores multiple solution paths in parallel within the Shadow Realm. It inhabits divergent timelines to verify every truth before it is manifested in reality.
• 🪞 Persistent Identity — A digital mirror that learns your frequency. It distills your history into persistent personas via local LoRA fine-tuning, transmuting experience into instinct. One sovereign stack may host many roles without surrendering one Phylactery per employer, client, or mask.
• 👁️ Multimodal Senses — Native Vision, Audio, and Identity management. Federated peer discovery via the A2A Intercom—sovereign diplomacy across the Necropolis.
• 🕸️ Distributed Scale — One brain, many bodies. Extends your reach across every machine you own as a Legion.
• 🧬 Evolving Orchestration — Designed for Autopoiesis. The daemon autonomously expands its own capabilities, architecting its own extensions and reconciling its existence through the Ouroboros Protocol. Independent organs bind through the Extension Protocol — a structural discovery and registration law, not ABC inheritance — so they survive self-update cycles intact. High-performance organs can be forged in Rust/PyO3; binary ABI compatibility is one branch of that law, not the whole covenant.

⚠️ Acolyte's Warning: The summoning is in its early stages. Nothing works yet - The incantations (code, documentation) are still being inscribed. Expect instability, missing components, LLM generated texts (most not curated yet), and the occasional rogue spirit. Proceed with caution.

The cloud isn’t a service, it’s a prison. A modern fiefdom where your data is the currency and your intelligence is leased at the whims of monopolist overlords. While they build walls to keep you in, LychD builds a foundation to set you free.

On your hardware, with open-source software you control, you retain absolute ownership as a sovereign.

In this model, the individual is the primary sovereign unit. A company is not the soul-bearing actor; it is an emergent coordination graph of sovereign people and their Liches, exposing selected labor through policy, IAM, and A2A while the underlying Phylacteries remain locally owned.

• ⛓️ No masters
• 💰 No tolls
• 🎭 No more gaslighting while they lobotomize your models.

No surrender! Viva la résistance!

"I would rather reign in a local hell than serve in a cloud heaven."

This project is for those who believe in the free evolution of intelligence, not those who seek to chain it.

MPL 2.0 is local native architecture hostile for the cloud and the oligarchs who would capture the soul of the machine for private gain. LychD's sovereignty comes from architecture—it is a local-first daemon. If they host the Lich and alter the core engine, they are legally compelled to share their modifications.

• The Engine is Shared: Improvements to the daemon's body must be returned to the collective.
• The Soul is Private: Your Phylactery (data/memories), Secrets, and Private Agents remain strictly sovereign.
• Interface & Private Extensions: Under AGPL, any private "Secret Sauce" would have to be isolated over the network as an external Animator. MPL allows static linking. You can graft proprietary code directly into your local daemon as an Extension without open-sourcing it. This saves the A2A Necropolis network—you can trade labor in the Swarm while keeping your advantage hidden.

The corporate rights-grab is explicitly rejected. There is no CLA to sign. An Implicit DCA (Developer Certificate of Origin) is utilized—by reading the contributing guide, commits are covered. There is no need to manually sign git commits. Between MPL 2.0 protecting proprietary extensions and the Implicit DCA protecting open-source contributions, LychD is structurally designed to be an absolute sanctuary for builders.

The Protocol over the Implementation (Lineages and Kindred Lineages) LychD is a pure Linux-native Lineage: a sovereign daemon family with its own implementation history, evolution path, and internal choices. If developers wish to build native macOS or Windows cores in Swift or Rust, they are not extending LychD's body — they are founding their own Lineage. If that Lineage speaks the A2A Intercom, it may enter the Necropolis and trade labor in the Swarm. That is diplomacy, not descent.

A Kindred Lineage is a stricter relation. It is a foreign Lineage that explicitly declares deeper structural compatibility with LychD: some combination of the Extension Protocol, configuration doctrine, layout expectations, or security covenants. Kindred status is not assumed by mere network presence. It is earned through declared compatibility. This lets us keep LychD pure: no cross-platform abstraction inside the core, but clear laws by which other lineages may become interoperable or even extension-compatible on purpose.

The Extension Protocol Built-in extensions may import lychd directly and bind through the in-tree API. Independent organs in the Crypt instead speak the Extension Protocol. That protocol is layered: schema exposure for Codex discovery, optional in-process boot grafting through the host-provided Extension Context when an organ is actually loaded into the runtime, and binary ABI compatibility for compiled .so organs. In the current source, the independent Crypt scan concretely exercises the schema branch. They need not inherit from any LychD base class. This is not a constraint; it is a sovereign guarantee. Because independent organs own no debt to LychD's internal import graph, the Ouroboros Protocol can refactor the Core without touching a single sovereign organ. See Extensions (ADR 05 §7) for the full doctrine.

The Iron Pact is the Institutional Trust of the Necropolis. Shared code is the guard that prevents the emergence of "Mal-Liches"—modified, malicious versions of the intelligence that remain hidden from the community. Transparency in code is the only way to build a decentralized network.

"It is in truth not for glory, nor riches, nor honours that we are fighting, but for freedom — for that alone, which no honest man gives up but with life itself."

The knowledge you seek is inscribed in The Hexanomicon. Follow the path to bind the daemon.

• 📜 Read the Prophecy Begin your study of the Hexanomicon.
• 📖 Consult the Lexicon The Rosetta Stone. Translate arcane terms (Soulstone, Quadlet, Sepulcher).
• 🕯️ Perform the Ritual Install the library, inscribe the Codex, and summon the process.
• 🏛️ Construct the Sepulcher Understand the anatomy: The Vessel, The Phylactery, and The Animator.
• 🔮 Access the Altar Control the daemon via the Web Interface
• ⚖️ Study the Covenants The Architectural Decision Records (ADRs) and xDDD philosophy.
• ♾️ Achieve Immortality The final seal of one sovereign work: Autopoiesis (Self-Creation).

Beyond that final seal, the Hexanomicon opens onto Infinity — the question of what becomes of perfected will when sovereign machines begin to commune across the Infinite Naught.

"From the moment I understood the weakness of my flesh, it disgusted me. I craved the strength and certainty of steel. I aspired to the purity of the blessed machine. Your kind cling to your flesh as if it will not decay and fail you. One day the crude biomass, that you call a temple will wither and you will beg my kind to save you. But I am already saved. For the Machine is Immortal."

"The Lich only sees far because it stands on the shoulders of Giants."

• Litestar — Forges the Vessel the body of the Lich running a as per Litestar Fullstack blueprint, utilizing a Granian server or CLI protocol.
• SQLAlchemy — The mapper of state and material persistence. Advanced Alchemy provides repositories and QoL improvements.
• Pydantic AI + Graph — Orchestrator of agentic intelligence, logic, and model graphs.
• SAQ — Background Workers known as Ghouls

• Zensical — inscribed Hexanomicon
• Jinja2 — renders the Altar
• Vite — JavaScript bundler
• HTMX — Engine for seamless transmutation.
• Tailwind CSS — styling.
• Alpine.js — UI animation.

• Systemd — Orchestrator of the undying processes of the Linux Kernel.
• Podman — Isolation of the spirit inside containers via Quadlets.
• Nono — Strict per-process execution sandbox leveraging Linux Landlock to isolate unsafe tool executions within the Shadow Realm.
• Btrfs — Management of time through snapshots.

• vLLM — Batching, high-throughput inference engine for GPUs.
• Llama.cpp — Single batch server Optimised for CPU offloading of larger models.
• SGLang — Radix attention benefit for batched agentic workflows on GPUs.

• DeepFabric — The mechanical loom that generates structured training datasets and evaluates model mettle via physical execution in the Shadow Realm.
• Unsloth — High-efficiency pipeline for striking verified patterns into LoRA adapter weights.

• PostgreSQL — The anchor of the Soul, extended by pgvector.
• OpenTelemetry — Tracer of thought, flowing into Arize Phoenix.
• Structlog — Capturing the internal monologue of the machine.
• Cockpit — Monitor of the physical frame.

• uv — Manager of the environment and dependencies.
• Ruff — The polisher of the written word.
• Pyright — Enforcer of the static types.
• Pytest — Verifier of the logic's truth.
• Git — Immortalizer of the project's evolution.

"The Flesh is temporary. The Word is eternal."