sigillin

The poetic-symbolic interface layer – self-referential sigils that bind fieldtheory, cosmic moments and entropy governance into living resonance.

Installation

pip install sigillin
# or
uv add sigillin

# Full GenesisAeon stack integration
pip install "sigillin[stack]"

Usage

# Validate a sigil against the CREP schema
sig validate codex-sigil.yaml

# Render MandalaMap resonance spectrum
sig render cosmic-web.yaml

# Inspect sigil fields
sig inspect codex-sigil.yaml

# Create a self-referential provider bridge
sig bridge openai

Sigil format (trilayer: YAML / JSON / Markdown)

Sigillin accepts three source formats:

# codex-sigil.yaml
coherence: 0.97
resonance: 0.88
emergence: 0.92
poetics: "The first sigil – carrier of the primal pattern."

{ "coherence": 0.97, "resonance": 0.88, "emergence": 0.92, "poetics": "..." }

---
coherence: 0.97
resonance: 0.88
emergence: 0.92
poetics: "The first sigil – carrier of the primal pattern."
---
# Codex Prime

Full narrative description here.

CREP validation

Every sigil is validated against four pillars:

from sigillin import Sigil

sigil = Sigil("codex-sigil.yaml")
sigil.validate_crep()   # True / False
sigil.assert_crep()     # raises SigilValidationError if invalid

MandalaMap resonance

spectrum = sigil.render_mandala(depth=0.618)  # φ-scaled resonance array
print(f"Peak: {spectrum.max():.4f}")

Stack integration

With pip install sigillin[stack], sigillin binds directly to the full GenesisAeon stack:

sigil.bind_to_field()   # returns Lagrangian string from fieldtheory

from sigillin.entropy_table_bridge import export_to_entropy_table
export_to_entropy_table("codex-sigil.yaml")

Python API

from sigillin import Sigil

sigil = Sigil("codex-sigil.yaml")
print(sigil["coherence"])          # 0.97
print(sigil.get("tags", []))       # []
print(repr(sigil))                 # Sigil(path=..., crep_valid=True)

Role in the GenesisAeon Ecosystem

sigillin (P-SIGIL) is the symbolic interface layer of the GenesisAeon stack: it provides the semantic state anchors and trilayer sigil format that bind fieldtheory, cosmic-moment, medium-modulation, and entropy-governance into a shared, validatable representation.

License

This repository is dual-licensed:

• Source code — GNU General Public License v3.0 or later (GPL-3.0-or-later)
• Documentation (this README, docs/, and other written content) — Creative Commons Attribution 4.0 International (CC BY 4.0)

See LICENSE for details.

Citation

If you use sigillin in research, please cite via the Zenodo DOI above. A new DOI version is minted automatically on each GitHub Release once Zenodo-GitHub integration is enabled for this repo.

Built with uv · Typer · Rich · NumPy