Skip to content

harvard-edge/cs249r_book

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Machine Learning Systems

Principles and Practices of Engineering Artificially Intelligent Systems

Build Last Commit

Website Ecosystem Paper

Funding License Powered by Netlify

📖 Read Online💾 Download PDF💾 Download ePub🌐 Explore Ecosystem

📚 Hardcopy edition coming 2026 via MIT Press!


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.

Stars

Goal: 10,000 stars = $100,000 in additional education funding

⭐ Star Nowtakes 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.

Open Collective

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

Start Contributing →


🛠️ 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

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.


🙏 Contributors

Thanks goes to these wonderful people who have contributed to making this resource better for everyone:

Vijay Janapa Reddi
Vijay Janapa Reddi

Zeljko Hrcek
Zeljko Hrcek

Marcelo Rovai
Marcelo Rovai

jasonjabbour
jasonjabbour

Ikechukwu Uchendu
Ikechukwu Uchendu

Kai Kleinbard
Kai Kleinbard

Naeem Khoshnevis
Naeem Khoshnevis

Sara Khosravi
Sara Khosravi

Douwe den Blanken
Douwe den Blanken

Jeffrey Ma
Jeffrey Ma

shanzehbatool
shanzehbatool

Elias
Elias

Jared Ping
Jared Ping

Itai Shapira
Itai Shapira

Maximilian Lam
Maximilian Lam

Jayson Lin
Jayson Lin

Andrea
Andrea

Sophia Cho
Sophia Cho

Alex Rodriguez
Alex Rodriguez

Korneel Van den Berghe
Korneel Van den Berghe

Zishen Wan
Zishen Wan

Colby Banbury
Colby Banbury

Mark Mazumder
Mark Mazumder

Divya Amirtharaj
Divya Amirtharaj

Srivatsan Krishnan
Srivatsan Krishnan

Abdulrahman Mahmoud
Abdulrahman Mahmoud

Aghyad Deeb
Aghyad Deeb

marin-llobet
marin-llobet

Haoran Qiu
Haoran Qiu

oishib
oishib

Jared Ni
Jared Ni

ELSuitorHarvard
ELSuitorHarvard

Emil Njor
Emil Njor

Michael Schnebly
Michael Schnebly

Aditi Raju
Aditi Raju

Jae-Won Chung
Jae-Won Chung

Yu-Shun Hsiao
Yu-Shun Hsiao

Henry Bae
Henry Bae

Shvetank Prakash
Shvetank Prakash

Emeka Ezike
Emeka Ezike

Andrew Bass
Andrew Bass

Jennifer Zhou
Jennifer Zhou

Arya Tschand
Arya Tschand

Pong Trairatvorakul
Pong Trairatvorakul

Matthew Stewart
Matthew Stewart

Marco Zennaro
Marco Zennaro

Eura Nofshin
Eura Nofshin

Bruno Scaglione
Bruno Scaglione

Tauno Erik
Tauno Erik

Alex Oesterling
Alex Oesterling

gnodipac886
gnodipac886

Fin Amin
Fin Amin

Allen-Kuang
Allen-Kuang

TheHiddenLayer
TheHiddenLayer

Gauri Jain
Gauri Jain

Fatima Shah
Fatima Shah

Sercan Aygün
Sercan Aygün

The Random DIY
The Random DIY

Baldassarre Cesarano
Baldassarre Cesarano

Yang Zhou
Yang Zhou

yanjingl
yanjingl

Abenezer Angamo
Abenezer Angamo

Jason Yik
Jason Yik

अरनव शुक्ला | Arnav Shukla
अरनव शुक्ला | Arnav Shukla

Aritra Ghosh
Aritra Ghosh

happyappledog
happyappledog

abigailswallow
abigailswallow

Bilge Acun
Bilge Acun

Andy Cheng
Andy Cheng

Cursor Agent
Cursor Agent

Emmanuel Rassou
Emmanuel Rassou

Jessica Quaye
Jessica Quaye

Vijay Edupuganti
Vijay Edupuganti

Shreya Johri
Shreya Johri

Sonia Murthy
Sonia Murthy

Costin-Andrei Oncescu
Costin-Andrei Oncescu

formlsysbookissue
formlsysbookissue

Annie Laurie Cook
Annie Laurie Cook

Jothi Ramaswamy
Jothi Ramaswamy

Batur Arslan
Batur Arslan

Curren Iyer
Curren Iyer

Fatima Shah
Fatima Shah

Edward Jin
Edward Jin

a-saraf
a-saraf

songhan
songhan

jvijay
jvijay

Zishen
Zishen


Made with ❤️ for AI learners worldwide

Our goal is to educate 1 million AI systems engineers for the future at the edge of AI.

# Trigger build