start/hereWelcome. This is a simple, actionable landing page into the Active Inference Ecosystem and Institute, centered on this repository. If you only read one file to begin, make it this one.
pytest.inilearning/curriculum_creation/1_Research_Domain.py, learning/curriculum_creation/1_Research_Entity.py, learning/curriculum_creation/2_Write_Introduction.pylearning/curriculum_creation/3_Introduction_Visualizations.pydata/visualizations/ (e.g., *_flow.mmd, *_section_breakdown.png, curriculum_structure.mmd)learning/curriculum_creation/4_Translate_Introductions.pydata/translated_curriculums/ (Chinese, French, Spanish, Tagalog)learning/curriculum_creation/generate_custom_curriculum.pydata/written_curriculums/ (organized by topic)uv run start-curriculum --helpuv run start-validate-outputs --checkuv run start-regenerate-offline --output-dir /tmp/start-fixtures --jsonsrc/
src/common/src/system/src/visualization/src/terminal/src/perplexity/, src/repos/data/
data/prompts/data/domain_research/, data/audience_research/data/visualizations/data/written_curriculums/, data/translated_curriculums/Documentation: docs/ (rendered site in site/)
Tests: tests/ (end-to-end and unit tests; pytest.ini config)
run.sh, run_docs.sh, pyproject.toml, mkdocs.ymltests/.Thanks for being here. This project aims to make active inference practical, legible, and collaborative. Start small, ship something real, and share what you learn.
For readers who want to move into formalism and implementation.
uv sync --all-extras --dev
uv run pytest -q
uv run python learning/curriculum_creation/generate_custom_curriculum.py --help
chmod +x ./run_docs.sh && ./run_docs.sh
Equations are supported via LaTeX in Markdown. For example, variational free energy:
\[F(q) = \mathbb{E}_{q(z)}[\log q(z)] - \mathbb{E}_{q(z)}[\log p(x, z)]\]and Bayes’ rule:
$ p(z\mid x) = \frac{p(x\mid z)\,p(z)}{p(x)} $.
uv run pytest -q && uv run ruff check . && uv run black --check .
uv run start-curriculum --non-interactive --stages domain-research entity-research \
--run-id research-001 --json
uv run start-curriculum --non-interactive --stages curriculum \
--run-id curriculum-001 --json
uv run start-curriculum --non-interactive --stages visualizations translations \
--languages Spanish French --run-id render-001 --json
data/domain_research/data/visualizations/data/written_curriculums/data/translated_curriculums/