14eb009bba
📚 Documentation Updates: - Updated README.md with current binder commands - Removed references to hello command (replaced with doctor) - Updated CLI README.md to remove binder_legacy references - Updated BINDER.md with current command set and shortcuts - Removed check/check-tags from all documentation - Updated doctor.py to only check for binder executable 🎯 Key Changes: - All docs now reference current binder commands only - Consistent command examples throughout documentation - Updated shortcuts to match current CLI aliases - Removed legacy command references - Focus on build-centric workflow as intended ✅ Documentation Consistency: - README.md: Updated quick start and development sections - cli/README.md: Removed legacy references - docs/BINDER.md: Updated command tables and examples - All examples use current binder command structure
Machine Learning Systems
Principles and Practices of Engineering Artificially Intelligent Systems
About This Book
The open-source textbook that teaches you to build real-world AI systems — from edge devices to cloud deployment. Originally developed as Harvard University's CS249r course by Prof. Vijay Janapa Reddi, now used by universities and students worldwide.
Our mission: Expand access to AI systems education worldwide — empowering learners, one chapter and one lab at a time.
Why This Book Exists
"This grew out of a concern that while students could train AI models, few understood how to build the systems that actually make them work. As AI becomes more capable and autonomous, the critical bottleneck won't be the algorithms - it will be the engineers who can build efficient, scalable, and sustainable systems that safely harness that intelligence."
— Vijay Janapa Reddi
📚 What You'll Learn
Go beyond training models — master the full stack of real-world ML systems.
| Topic | What You'll Build |
|---|---|
| System Design | Scalable, maintainable ML architectures |
| Data Engineering | Robust pipelines for collection, labeling, and processing |
| Model Deployment | Production-ready systems from prototypes |
| MLOps & Monitoring | Reliable, continuously operating systems |
| Edge AI | Resource-efficient deployment on mobile, embedded, and IoT |
⭐ Support This Work
Show Your Support
Star this repository to help us demonstrate the value of open AI education to funders and institutions.
Goal: 10,000 stars = $100,000 in additional education funding
⭐ Star Now — takes 2 seconds!
Fund the Mission (New!)
We've graduated this project from Harvard to enable global access and expand AI systems education worldwide. Please help us support educators globally, especially in the Global South, by providing TinyML kits for students, funding workshops, and sustaining our open-source infrastructure.
From $15/month to sponsor a learner to $250 for workshops — every contribution democratizes AI education.
🌐 Community & Resources
| Resource | Description |
|---|---|
| 📚 Main Site | Complete learning platform |
| 🔥 TinyTorch | Educational ML framework |
| 💬 Discussions | Ask questions, share insights |
| 👥 Community | Join our global learning community |
🎯 For Different Audiences
🎓 Students
👩🏫 Educators
🛠️ Contributors
🚀 Quick Start
For Readers
# Read online (continuously updated)
open https://mlsysbook.ai
# Or download PDF for offline access
curl -O https://mlsysbook.ai/Machine-Learning-Systems.pdf
For Contributors
git clone https://github.com/harvard-edge/cs249r_book.git
cd cs249r_book
# Quick setup (recommended)
./binder setup # Setup environment and dependencies
./binder doctor # Check system health
# Fast development workflow
./binder preview intro # Fast chapter development
./binder build intro # Build specific chapter
./binder build # Build complete book (HTML)
./binder help # See all commands
🤝 Contributing
We welcome contributions from the global community! Here's how you can help:
Ways to Contribute
- 📝 Content — Suggest edits, improvements, or new examples
- 🛠️ Tools — Enhance development scripts and automation
- 🎨 Design — Improve figures, diagrams, and visual elements
- 🌍 Localization — Translate content for global accessibility
- 🔧 Infrastructure — Help with build systems and deployment
Quality Standards
All contributions benefit from automated quality assurance:
- ✅ Pre-commit validation — Automatic cleanup and checks
- 📋 Content review — Formatting and style validation
- 🧪 Testing — Build and link verification
- 👥 Peer review — Community feedback
🛠️ Development
Book Binder CLI (Recommended)
The Book Binder is our lightning-fast development CLI for streamlined building and iteration:
# Chapter development (fast iteration)
./binder preview intro # Build and preview single chapter
./binder preview intro,ml_systems # Build and preview multiple chapters
# Complete book building
./binder build # Build complete website (HTML)
./binder pdf # Build complete PDF
./binder epub # Build complete EPUB
# Management
./binder clean # Clean artifacts
./binder status # Show current status
./binder doctor # Run health check
./binder help # Show all commands
Development Commands
# Book Binder CLI (Recommended)
./binder setup # First-time setup
./binder build # Build complete HTML book
./binder pdf # Build complete PDF book
./binder epub # Build complete EPUB book
./binder preview intro # Preview chapter development
# Traditional setup (if needed)
python3 -m venv .venv
source .venv/bin/activate
pip install -r tools/dependencies/requirements.txt
pre-commit install
Project Structure
MLSysBook/
├── binder # ⚡ Fast development CLI (recommended)
├── quarto/ # Main book content (Quarto)
│ ├── contents/ # Chapter content
│ │ ├── core/ # Core chapters
│ │ ├── labs/ # Hands-on labs
│ │ ├── frontmatter/ # Preface, acknowledgments
│ │ ├── backmatter/ # References and resources
│ │ └── parts/ # Book parts and sections
│ ├── _extensions/ # Quarto extensions
│ ├── config/ # Build configurations
│ │ ├── _quarto-html.yml # Website build configuration
│ │ └── _quarto-pdf.yml # PDF build configuration
│ ├── data/ # Cross-reference and metadata files
│ ├── assets/ # Images, styles, media
│ ├── filters/ # Lua filters
│ ├── scripts/ # Build scripts
│ └── _quarto.yml # Active config (symlink)
├── tools/ # Development automation
│ ├── scripts/ # Organized development scripts
│ │ ├── content/ # Content management tools
│ │ ├── cross_refs/ # Cross-reference management
│ │ ├── genai/ # AI-assisted content tools
│ │ ├── maintenance/ # System maintenance scripts
│ │ ├── testing/ # Test and validation scripts
│ │ └── utilities/ # General utility scripts
│ ├── dependencies/ # Package requirements
│ └── setup/ # Setup and configuration
├── config/ # Project configuration
│ ├── dev/ # Development configurations
│ ├── linting/ # Code quality configurations
│ └── quarto/ # Quarto publishing settings
├── docs/ # Documentation
│ ├── BINDER.md # Binder CLI guide
│ ├── BUILD.md # Build instructions
│ ├── DEVELOPMENT.md # Development guide
│ └── contribute.md # Contribution guidelines
├── CHANGELOG.md # Project changelog
├── CITATION.bib # Citation information
├── pyproject.toml # Python project configuration
└── README.md # This file
Documentation
- ⚡ Binder CLI Guide — Fast development with the Book Binder
- 📋 Development Guide — Comprehensive setup and workflow
- 🛠️ Maintenance Guide — Daily tasks and troubleshooting
- 🔨 Build Instructions — Detailed build process
- 🤝 Contribution Guidelines — How to contribute effectively
Publishing
# Interactive publishing (recommended)
./binder publish
# Command-line publishing
./binder publish "Description" COMMIT_HASH
# Manual workflow (if needed)
./binder build html && ./binder build pdf
# Then use GitHub Actions to deploy
Publishing Options:
./binder publish— Unified command with interactive and command-line modes- GitHub Actions — Automated deployment via workflows
Getting Started
# First time setup
./binder setup
# Check system health
./binder doctor
# Quick preview
./binder preview intro
📋 Citation & License
Citation
@inproceedings{reddi2024mlsysbook,
title = {MLSysBook.AI: Principles and Practices of Machine Learning Systems Engineering},
author = {Reddi, Vijay Janapa},
booktitle = {2024 International Conference on Hardware/Software Codesign and System Synthesis (CODES+ ISSS)},
pages = {41--42},
year = {2024},
organization = {IEEE},
url = {https://mlsysbook.org}
}
License
This work is licensed under Creative Commons Attribution–NonCommercial–ShareAlike 4.0 International (CC BY-NC-SA 4.0). You may share and adapt the material for non-commercial purposes with appropriate credit.
Made with ❤️ for AI learners worldwide
Our goal is to educate 1 million AI systems engineers for the future at the edge of AI.