Technical documentation for the ActiveInferenceJournal data repository. The journal is a source-namespaced corpus of transcripts, metadata, captions, translations, and curated materials from the Active Inference Institute video library.
| Doc | What it covers |
|---|---|
SCHEMA.md |
Canonical per-item schema (metadata.json, transcript.*, captions/, translations/, assets/) and the INDEX.json contract. |
ORGANIZATION.md |
The top-level namespace (data/video/<source>/, data/<type>/<source>/), how series and items are organized, and how to add other channels / non-video sources. |
PIPELINE.md |
How content is produced and kept complete + idempotent — the collaboration with the Journal_Utilities engine. |
translation-migration-map.md |
Item-by-item map of the legacy Translations/ → translations/<video_id>.<bcp47>.srt migration (M2 part 1: documentation only, moves happen in a reviewed follow-up). |
- Machine entry point:
../INDEX.json— every item, its videos, and paths. - Human entry point:
../INDEX.mdand the repo../README.md. - Content root:
../data/video/activeinferenceinstitute/. - Repo-level guides:
../CONTRIBUTING.md(what to edit vs. generated),../SECURITY.md(credentials/audio rules),../CITATION.cff(Zenodo citation),../TO-DO.md(scoped improvement list). - Tooling (separate repo):
Journal-Utilities
produces this layout; its
scripts/refactor_journal.pyandscripts/download_channel.pyare the canonical generators. Itsscripts/validate_journal.pyis the read-only integrity gate. See Journal-Utilitiesdocs/JOURNAL_SCHEMA.mdanddocs/REFACTOR_READINESS.md.
main— content without audio (lightweight).audio—main+<item>/audio/<name>.64k.m4a(64 kbps media), same layout.
See also: m4-site-spec.md — spec for the M4 static
per-item pages + sitemap/robots (for the Journal_Utilities builder agent) —
and misfiling-findings.md — captions/translations
misfiling dispositions (Textbook Cohort 2 Meeting 20 SRT; 2021 Symposium
Translations/ robotics duplicates).