Lenia Swarm docs

Lenia Swarm runs Flow Lenia simulations, indexes the persistent patterns they produce into a SQLite compendium, and measures and groups those patterns. LeniaCLI and LeniaStudio do the computation; spctr surface preserves and publishes declared surfaces such as lenia-compendium.

Start here

• Primer: what is simulated and recorded, the physics terms, and the glossary.
• Running a local sweep: build LeniaCLI, run a sweep, read the run directory, and keep it reproducible.
• Config map: the config families every run starts from.

Measuring and grouping creatures

• Morphology and morphometrics: the vocabulary of form and behavior, and the measurements stored for each creature.
• Taxonomy: how LeniaCLI analyze taxonomy assigns family, genus and species IDs.
• Ecology: how creatures spread across parameter space, and the LeniaCLI analyze ecology export.

Running experiments

• Paper reproductions: the seven paper-grounded run families, their entry points, outputs, code and gaps.
• The compendium: schema, migrations, indexer behavior, Studio reads, and the exact-version rule.

Inside the simulator

• FlowLenia.swift parameter mapping: how the Swift parameters map onto the Flow-Lenia paper’s equations.
• Flow coordinates and the reference regression: axis order and gradient signs in the integrator, and the tests against the reference implementation.
• Species knobs for glider search: which parameters define a species and which can vary.

Layout

• universe/: concepts and research vocabulary.
• contracts/: interfaces and guarantees (CLI, schema, run directory, reproducibility).
• configs/: configuration families and canonical entry files.
• internals/: implementation details tied to source files.