EduLLM Experiments

Architecture-first LLM pipeline for educational content generation.

Quick Start

cd "Question Generation"
pip install -e .
cp .env.example .env  # Add API keys

# Generate questions
python scripts/generate_questions.py 10 42 5

Architecture

design/ folder:

• ADRs - Why Langfuse, Pydantic, versioned prompts
• DomainModel - Core entities
• SequenceDiagrams - Component flows
• guards/ - Automated enforcement

Protection layers:

1. Design guards → Architecture compliance
2. MyPy strict → Type safety
3. Pydantic → Runtime validation
4. Tests → Behavior locked

Development

pip install -e ".[dev]"
pre-commit install

# Run gates
pre-commit run --all-files
pytest tests/