Start

Active Inference Curriculum Creation Pipeline

Overview

The START project provides a pipeline for creating personalized Active Inference and Free Energy Principle curricula. Live provider calls are optional; offline fixtures and synthetic foundation material are explicitly labeled and never treated as live evidence.

Pipeline Stages

Stages

Each run has a stable run ID, a filesystem checkpoint directory, and an atomic manifest.json. Required-stage failures make PipelineResult.ok false; optional-stage failures remain visible in structured stage results.

Links

1. Acquire 🔍

2. Prepare and Process ✍️

3. Parse and Render 📊

4. Multilingual Translation 🌍

Script Entrypoints

Staged Entrypoints

# Numbered files remain importable staged entrypoints; use the canonical runner.
learning/curriculum_creation/1_Research_Domain.py    # Domain analysis
learning/curriculum_creation/1_Research_Entity.py    # Audience profiling  
learning/curriculum_creation/2_Write_Introduction.py # Curriculum generation
learning/curriculum_creation/3_Introduction_Visualizations.py # Charts & diagrams
learning/curriculum_creation/4_Translate_Introductions.py     # Multilingual output

Supporting Infrastructure

src/perplexity/           # Perplexity API integration
src/common/               # Shared utilities (paths, config, prompts)
src/config/               # Configuration management
src/visualization/        # Visualization generation

Data Architecture

Input Configuration

data/config/
├── entities.yaml         # Target learner profiles
├── domains.yaml          # Professional domains
└── languages.yaml        # Translation targets and scripts

Research Outputs

data/
├── audience_research/     # Personalized learner analysis
├── domain_research/       # Professional domain analysis
├── written_curriculums/   # Generated curriculum content
├── translated_curriculums/ # Multilingual versions
└── visualizations/        # Charts and diagrams

Template System

data/prompts/
├── research_domain_analysis.md     # 6-section domain framework
├── research_domain_curriculum.md   # Prompt-defined curriculum generation
├── research_entity.md              # 6-section personalization
├── curriculum_section.md           # Comprehensive module creation
└── translation.md                  # 7-section multilingual framework

Enhanced Features

Configuration-Driven Research

Advanced Command-Line Interface

# Filter by priority and category
uv run start-curriculum --non-interactive --stages domain-research \
  --domain-priority high --domain-category life_sciences --json

# Process specific targets
uv run start-curriculum --non-interactive --stages entity-research \
  --entities karl_friston --overwrite --json

# Multilingual output with specific languages
uv run start-curriculum --non-interactive --stages translations \
  --languages Spanish French German --json

Comprehensive Content Generation

API Integration

Perplexity API (Research)

OpenRouter API (Content Generation)

Quality Assurance

Content Standards

Technical Standards

Operational commands

# Plan without contacting providers
uv run start-curriculum --non-interactive --dry-run --run-id plan-001 --json

# Validate generated text and JSON contracts without modifying data
uv run start-validate-outputs --check

# Regenerate a deterministic, explicitly synthetic fixture
uv run start-regenerate-offline --output-dir /tmp/start-fixtures --run-id fixture-001 --json

# Inspect or conservatively prune filesystem-backed run history
uv run start-run-history --root data/written_curriculums/.runs --json
uv run start-run-history --root data/written_curriculums/.runs --keep 10 --prune --json

Cross-References