Skip to content

Animator

"The Construct is perfect. The Runes are inscribed. Yet, the machine lies silent in the Crypt. The Animator is the arcane current that strikes the cold iron and commands it to THINK."

The Animator is the subsystem responsible for Inference Abstraction. It is the unified definition of an "Intelligence" within the LychD ecosystem.

In the code, the Animator is the Base Specification from which all cognition descends. Whether the mind is a massive local model occupying your GPU's VRAM, or a distant API endpoint in a datacenter, they are all Animators. They all obey the same laws of identity and behavior.

📜 The Holy Contract

The Vessel does not care where the intelligence comes from—only that it answers the summons. To enforce this, the Animator defines a strict Contract of Existence. Any entity that wishes to speak through the Lich must possess a set of Capabilities.

The Universal Tongue

The Lich speaks only one language: Strict, Typed JSON.

The Animator standardizes all sources of power into a single interface compliant with the OpenAI API Standard. This creates a powerful abstraction:

  • Capability-Based Routing: You no longer request a "Model." You request a Capability Set (e.g., {"text-generation", "vision"}). The system identifies the best Animator to fulfill the intent.
  • Hot-Swappable Souls: You can banish a local model and summon a Cloud Portal without changing a single line of Agentic logic.
  • Unified Personality: Every Animator inherits standard Generation Parameters, ensuring even alien cloud models respect your preferred "Temperature."

âš¡ The Sources of Power

The Animator draws its energy from two distinct types of sources, inscribed in your Codex.

Soulstones

"The Trapped Spirit."

  • Nature: Local, Containerized, Stateful. These are the engines running within the Sepulcher itself. A Soulstone definition is the "Scroll" used by the system to forge a physical Systemd Rune. They belong to Covens and are subject to the Orchestrator's law of exclusivity.

Portals

"The Rift to the Void."

  • Nature: Remote, Ephemeral, Rented. These are connections to alien intelligences dwelling in the cloud. They generate no Runes and consume no VRAM. They represent "Burst" capacity or frontier reasoning, gated by the Sovereignty Wall.

🧠 The Intelligence Profile

Every Animator possesses a default "Personality" defined in its schema. These parameters govern the stochastic nature of the "Word."

Parameter Default Description
max_context 4096 The total window of the entity's working memory.
temperature 0.7 The chaos factor. Higher values breed creativity; lower values breed logic.
top_p 0.9 The nucleus sampling threshold.
max_tokens 4096 The limit of the entity's breath before it must stop speaking.

🫀 The Galvanic Arc

The Animator is the circuit that governs the cycle of Request and Response.

  1. The Impulse: An Agent requires a capability. It submits an Intent to the Orchestrator.
  2. The Manifestation: If the Animator is a Soulstone, the system ensures its Coven is active. If it is a Portal, it prepares the Rift.
  3. The Dispatch: The Dispatcher transmutes the Animator into a live pydantic_ai.Model.
  4. The Stream: Tokens flow back in real-time to the Altar.