How spurushothaman419/cs249r_book works
This is an integrated machine-learning-systems curriculum repository, not a single application. Its learner-facing path combines the textbook with interactive labs, modeling through MLSys·im, hands-on TinyTorch work, and assessment through StaffML; Socratiq adds reading support and quizzes. The graph also shows the Binder authoring/build CLI as an internal layer. Some companion capabilities are documented but not sampled, so those links rely on README statements rather than inspected implementation.
Main entry points: vol1 Interactive labs · main.py Binder CLI · build.py Book build · mlsysbook_labs Lab components
Components 31
Learning content
- Textbook series
books
Labs and modeling
- Interactive labs
labs/vol1 - Lab components
labs/mlsysbook_labs - Data pipeline models
labs/mlsysbook_labs/data_pipeline.py - Experiment evidence
labs/mlsysbook_labs/experiment_evidence.py - MLSys·im
mlsysim/mlsysim - Simulation engine
mlsysim/mlsysim/engine/engine.py - Solver pipeline
mlsysim/mlsysim/engine/pipeline.py - Unit system
mlsysim/mlsysim/core/units.py - Lab state
mlsysim/mlsysim/labs/state.py - Lab presentation
mlsysim/mlsysim/labs/style.py
Hands-on practice
- TinyTorch
tinytorch - TinyTorch CLI
tinytorch/tito/main.py - Learning milestones
tinytorch/tito/commands/milestone.py - Hardware kits
kits
Assessment and reading
- StaffML assessment
staffml/app/src/app - Socratiq learning
socratiq/src_shadow/js/components - Quiz persistence
socratiq/src_shadow/js/components/quiz/quiz-storage.js - Spaced repetition
socratiq/src_shadow/js/components/spaced_repetition/handlers/storage-handler.js - Browser database
socratiq/src_shadow/js/libs/utils/indexDb.js
Authoring tools
- Binder CLI
binder/cli/main.py - Book build
binder/cli/commands/build.py - Build configuration
binder/cli/core/config.py - Book discovery
binder/cli/core/discovery.py - Validation checks
binder/cli/commands/validate.py - EPUB checks
binder/cli/commands/_epub_checks.py - PDF checks
binder/cli/commands/_pdf_checks.py - Book information
binder/cli/commands/info.py - Layout tools
binder/cli/commands/layout.py - Maintenance tools
binder/cli/commands/maintenance.py
Other components
- Learner
Connections 30
- Learner → Textbook series: studies
README.md - Learner → Interactive labs: explores interactively
README.md - Interactive labs → MLSys·im: models infrastructure with
README.md - Learner → TinyTorch: builds internals with
README.md - Learner → Hardware kits: practices deployment on
README.md - Learner → StaffML assessment: demonstrates understanding in
README.md - Textbook series → Socratiq learning: supports guided reading
README.md - Socratiq learning → Quiz persistence: persists quiz results
socratiq/src_shadow/js/components/quiz/quiz-storage.js - Quiz persistence → Browser database: uses database
socratiq/src_shadow/js/components/quiz/quiz-storage.js - Socratiq learning → Spaced repetition: supports spaced repetition
README.md - Spaced repetition → Browser database: persists study data
- Interactive labs → Lab components: uses lab components
- Lab components → Experiment evidence: captures experiment evidence
labs/vol2/lab_04_data_storage.py - Lab components → Data pipeline models: uses data pipeline models
labs/mlsysbook_labs/data_pipeline.py - Interactive labs → Lab state: uses lab state
- Interactive labs → Lab presentation: uses shared presentation
- Interactive labs → Simulation engine: runs modeling experiments
- Simulation engine → Unit system: uses quantities
mlsysim/mlsysim/engine/engine.py - MLSys·im → Solver pipeline: provides solver pipeline
mlsysim/mlsysim/engine/pipeline.py - TinyTorch → TinyTorch CLI: offers learner workflow
README.md - TinyTorch CLI → Learning milestones: tracks progress
tinytorch/tito/main.py - Binder CLI → Book build: dispatches build
binder/cli/main.py - Binder CLI → Validation checks: dispatches validation
binder/cli/main.py - Binder CLI → Book information: dispatches information
binder/cli/main.py - Binder CLI → Layout tools: dispatches layout
binder/cli/main.py - Binder CLI → Maintenance tools: dispatches maintenance
binder/cli/main.py - Book build → Build configuration: loads configuration
binder/cli/commands/build.py - Book build → Book discovery: discovers book inputs
binder/cli/commands/build.py - Book build → EPUB checks: runs EPUB checks
binder/cli/commands/build.py - Book build → PDF checks: runs PDF checks
binder/cli/commands/build.py