Skip to content

Overview

CI   License

  • Build-your-own LLM system course 12 passes from math 0 to 1 through tokenizers, attention, KV caches, a Rust serving engine, a Go gateway, durable workflows, agents, and a local Kubernetes deploy, graded by ol check tests and runnable milestones
  • Free-first free learning routes, with paid books identified as optional references
  • Graded depth undergraduate foundations through PhD-level research topics
  • Multi-track math, algorithms, ML, systems, info theory, competitive programming
  • Interview-ready 19 company-specific guides across Big Tech, quant, and frontier
  • Role paths reading orders for one job across tracks, with checkable done-when criteria, in the terminal (ol learn) and as a per-role PDF
  • Practice path one CLI, three exercise kinds (predict, build, reattempt), attempts cloned to a gitignored scratchpad
  • Case studies real builds generalized into runnable, dependency-free implementations that test themselves
  • Prerequisite graph mermaid diagram showing topic dependencies
  • Single-PDF book the entire curriculum renders into one PDF in CI (build artifact + release asset)

Start with the end-to-end CS curriculum for an eight-term core, applied mathematics, specialization paths, and assessment requirements. See the source register for verified book references, access labels, and audit boundaries.

#TopicTextbookTime
00PrecalculusOpenStax Precalculus 2e (free)2-3 weeks
01Calculus 1OpenStax Calculus Vol 14 weeks
02Calculus 2OpenStax Calculus Vol 24 weeks
03Linear AlgebraHefferon’s Linear Algebra4 weeks
04Calculus 3OpenStax Calculus Vol 34 weeks
05Discrete Math 1Hammack’s Book of Proof4 weeks
06Discrete Math 2Levin’s Discrete Mathematics4 weeks
07Probability & StatisticsGrinstead & Snell + OpenStax Stats3-4 weeks
08Matrix Calculus & AutodiffParr & Howard + Baydin et al. (free)3 weeks
09Numerical Methods & Floating PointGoldberg (free) + Higham3-4 weeks
10OptimizationBoyd & Vandenberghe (free)3 weeks
11
#TopicLangREADME
01Arrays & HashingJSPatterns
02Two Pointers & Sliding WindowJSPatterns
03Binary SearchJSPatterns
04Linked ListsJSPatterns
05TreesPythonPatterns
06GraphsJS/TS/CPatterns
07Dynamic ProgrammingJS/Python/CPatterns
08GreedyJS/Python/JavaPatterns
09BacktrackingJS/PythonPatterns
10Math & Bit ManipulationJSPatterns
11Recursion & Divide-and-ConquerPythonPatterns
15Probabilistic StructuresPythonPatterns
16Systems Data StructuresC/Rust/GoPatterns

Topics 12 to 14 (historical coursework: concurrency, functional programming, ML labs) moved to archive/. Core references: CLRS (4th ed.), Competitive Programmer’s Handbook (free). See algorithms/README.md for full details.

#TopicTextbookTime
01Statistical LearningISLR (free) + ESL (free)4-5 weeks
02Deep LearningGoodfellow et al. on deeplearningbook.org (free)6-8 weeks
03Reinforcement LearningSutton & Barto (free) + Spinning Up4-6 weeks
04LLM Systems & InferenceML Systems (free) + vLLM docs (free)4-6 weeks
05Foundation Models & ArchitecturesAI Engineering (Huyen) + aie-book (free)4-5 weeks
06Neural Architectures & DL HistoryCS231n (free) + AlexNet/LSTM papers (free)3-4 weeks
07Training & Post-TrainingChinchilla + DPO papers (free) + PyTorch/JAX docs (free)4-6 weeks
08tinyllm: Build an LLM from Scratchthe course spine: chapters and course testscourse passes 1 to 11
#TopicPrimary ReferenceTime
01FoundationsData Engineering Cookbook (free) + Fundamentals of Data Engineering2-3 weeks
02Storage & WarehousingDDIA Ch 3 + The Data Warehouse Toolkit (Kimball)3-4 weeks
03Batch & StreamingStreaming Systems + Spark/Kafka docs (free)3-4 weeks
04Orchestration & Modelingdbt + Airflow docs (free)2-3 weeks
05Corpus PipelineFineWeb + datatrove (free)course passes 3, 8
#TopicReferenceTime
01System DesignByteByteGo + System Design Primer (free)4-5 weeks
02Software ArchitectureSoftware Architecture Patterns (O’Reilly)2-3 weeks
03Cloud NativeCloud Native DevOps with K8s + K8s docs (free)3-4 weeks
04ObservabilityObservability Engineering + Google SRE Book (free)2-3 weeks
05Incident Response & ChaosGoogle SRE Book + SRE Workbook (free)one drill per course pass

Taught as patterns, not products — like math, once you understand the fundamental patterns (cache-aside, consistent hashing, durable execution, the worker pool, retrieve-then-rerank, the complexity ladder of authorization, cross-entropy-as-compression), every trendy tool becomes a recognizable instance.

#TopicReferenceTime
01Training & FrameworksPyTorch + JAX + vLLM docs (free)4-6 weeks
02RPC & ProtocolsgRPC + Protocol Buffers docs (free)2-3 weeks
03Streaming & SSEHTML SSE spec + MDN SSE (free)1-2 weeks
04Distributed Data & CachingRedis + Cassandra docs (free) + DDIA3-4 weeks
05Durable Orchestration & WorkersTemporal + DBOS docs (free)2-3 weeks
06Coding & Design PatternsRefactoring Guru + Mostly Adequate Guide (free)2-3 weeks
07Retrieval & RAGRAG paper + BM25 + pgvector (free)3-4 weeks
08Authorization & Access ControlNIST RBAC/ABAC/NGAC + Zanzibar (free)2-3 weeks
09LLM EvaluationMacKay + HELM + Ragas (free)2-3 weeks
10Edge, Realtime & On-Device Inferencellama.cpp + Mistral 7B + Mamba (free)2-3 weeks
11Model Routing & CascadesRouteLLM + FrugalGPT + LLMRouterBench (free)1-2 weeks
12GatewayOpenAI API reference + W3C Trace Context (free)course passes 1, 7, 10
13Agent SDKBuilding effective agents + ReAct (free)course pass 10

Three distinct “distributed” problems kept apart on purpose: distributed training (parallelism — PyTorch/JAX, FSDP/ZeRO, Megatron, Ray Train; served with vLLM/TensorRT-LLM; plus embeddings and small language models), distributed data (sharding, replication, in-memory caching with Redis and cache-invalidation patterns, Cassandra, knowledge graphs via Apache AGE, OLAP vs OLTP), and distributed orchestration (durable execution and the worker pattern — Temporal/Cadence/DBOS — with distributed observability and profiling). Plus the connective tissue: gRPC and serialization, SSE token streaming, the coding/design patterns these systems are built from, production-grade retrieval (encoders, chunking, hybrid BM25 + vector + graph fusion, multimodal, metadata/permission filtering), authorization (RBAC/ABAC/NGAC and the pushdown-automata complexity ladder), evaluation (cross-entropy, perplexity, bits-per-byte, LLM-as-judge, RAG faithfulness), and edge/realtime inference (the end-to-end llama.cpp + GGUF local path, streaming speech encoders, and the efficiency architectures — sliding-window attention, GQA, MoE, Mamba/SSM — behind Mistral’s models).

TrackReferenceTime
Competitive ProgrammingCP Handbook (free) + CSES Problem Set6-8 weeks
Information TheoryStudent’s Guide to Coding & Info Theory + MacKay (free)3-4 weeks
Software CraftsmanshipThe Pragmatic Programmer + SWE at Google (free) + project postmortems; now also diagramming, documentation, and type systems3-4 weeks + 4-5 weeks
Responsible AIModel Cards + Datasheets + NIST AI RMF (free)course passes 3, 9, 10, 11
InfrastructureK8s + Kafka + Lucene/Elasticsearch + Apache docs (free)5-7 weeks
Field EngineeringDiscovery, sizing, performance testing engagements, POCs, migration, commercials, escalation for inference-cloud customers3-4 weeks
Case StudiesWorked builds with runnable, dependency-free implementations5-10 days
graph TD
    C1[Calculus 1] --> C2[Calculus 2]
    C2 --> C3[Calculus 3]
    LA[Linear Algebra] --> C3
    D1[Discrete Math 1] --> D2[Discrete Math 2]
    C2 --> PS[Prob & Stats]
    D1 --> PS
    D1 --> ALG[Algorithms]
    D2 --> ALG
    ALG --> CP[Competitive Programming]
    D1 --> PL[Type Systems]
    ALG --> PL
    PS --> SL[Statistical Learning]
    LA --> SL
    SL --> DL[Deep Learning]
    C3 --> DL
    DL --> RL[Reinforcement Learning]
    PS --> RL
    DL --> FM[Foundation Models]
    DL --> TPT[Training & Post-Training]
    RL --> TPT
    TPT --> LLM
    PS --> IT[Information Theory]
    LA --> IT
    ALG --> SYS[Systems & Architecture]
    SYS --> DE[Data Engineering]
    FM --> LLM[LLM Systems & Inference]
    DL --> LLM
    SYS --> LLM
    DE --> LLM
    SYS --> INFRA[Infrastructure]
    DE --> INFRA
    LLM --> AIP[AI Platform Engineering]
    LLM --> FE[Field Engineering]
    AIP --> FE
    DE --> RAI[Responsible AI]
    LLM --> RAI
    SYS --> AIP
    DE --> AIP

See STUDY-PLAN.md for structured schedules:

  • Math Foundations 16 weeks, all 7 math topics
  • Algorithm Mastery 21 days, all 15 algorithm topics
  • ML & AI 18-37 weeks, statistical learning through RL, LLM serving, foundation models, neural-architecture foundations, and training and post-training
  • Systems & Architecture 11-15 weeks, system design through observability
  • Data Engineering 10-14 weeks, foundations through orchestration and data quality
  • AI Platform Engineering 25-35 weeks, patterns-first: training/frameworks, RPC, streaming, distributed data & caching, durable orchestration, coding/design patterns, retrieval & RAG, authorization, LLM evaluation, edge/realtime inference, and model routing
  • Type Systems (Software Craftsmanship 07) 2-3 weeks, type systems and polymorphism from the lambda-calculus ladder through Hindley-Milner inference, variance, and generics across five languages
  • Diagramming & Documentation (Software Craftsmanship 05 and 06) 2 weeks, C4 diagramming-as-code and docs-as-code
  • Infrastructure 5-7 weeks, containers and Kubernetes through messaging, search, and the Apache stack (partitioned workers now live in AI Platform 05)
  • Superstar FDE 14 weeks, the composed role path: LLM foundations through inference performance, field engineering, and a one-customer capstone
  • Combined Path 40+ weeks, zero to Staff+ interview-ready
  • PhD Research Track deep learning research + information theory + RL

One system, built end to end in Python, Rust, and Go and graded by the harness: a byte-level language model trained on your own numerics, a Rust engine streaming completions, a Go gateway, and the containers, traces, and runbooks that run it on Kubernetes. Python and Rust exchange safetensors, tokenizer.json, and fixtures at file boundaries. Optional C modules are standalone exercises with their own test binaries. Each chapter teaches one module from first principles; ol check <ID> grades your code against course tests, and each built pass ends at a milestone that runs your system. Pass 12 is currently a design plan.

PassPathGate
P0Setup: Python and numpy, shell and make, your repo and its CI gateMS-P0
P1The tracer: byte bigram, Rust engine, Go gateway, kind, one trace, one drill, one ADRMS-P1
P2Foundations: autograd, gradient checking, and the training loopMS-P2
P3Tokens and data: tokenizers, text corpora, and n-gram modelsMS-P3
P4Sequence models: recurrent models, sequence-to-sequence, and beam searchMS-P4
P5Transformer: transformer variants, fine-tuning, and model loadingMS-P5
P6Inference and kernels: Python inference stack and optional standalone C exercisesMS-P6
P7Serving platform: Rust engine, Go gateway, routing, load, deployment, and observabilityMS-P7
P8Durable workflows: durable data and training workflowsMS-P8
P9Capstone training: train, evaluate, release, and serve a small modelMS-P9
P10Agents: agent SDK, retrieval, evaluation, and usage policyMS-P10
P11Operate: migrations, upgrades, chaos, security, and release readinessMS-P11
P12Multimodal plan: planned image and audio extensions; module chapters and implementation are not built yetplanned, not built

Start at paths/course and its system map:

Terminal window
practice/bin/ol doctor && practice/bin/ol course init --name <system> && practice/bin/ol learn course next

A path orders existing chapters for one job and says what “done” means at each stage; the tracks keep owning the content. Paths compose: six parts each stand alone for a narrower role, and Superstar FDE includes all six plus a capstone.

PathFor
Superstar FDEForward deployed engineer at an inference and fine-tuning cloud, end to end: every part below plus a one-customer capstone
LLM FoundationsHistory from n-grams to reasoning models, transformer math, architecture variants
Frameworks and ModelsPyTorch, JAX, Keras 3, and loading checkpoints from the Hugging Face Hub
TrainingRL foundations, pretraining, post-training (SFT, DPO, GRPO), LoRA
Inference PerformanceEngine internals, quantization, vLLM/SGLang serving and load testing
AI Full StackStreaming, retrieval, evaluation, routing
Field EngineeringDiscovery, sizing, performance testing engagements, POCs, migration, commercials, escalation
Terminal window
practice/bin/ol learn # every path and your progress
practice/bin/ol learn superstar-fde next # read the next unfinished stage

app/ is a desktop learning platform that renders a course pack: a directory of markdown with an openlearn.json manifest naming its tracks, role paths, and practice CLI. This repository is the pack built into it, and packs/languide/ (communication-first language guides) ships beside it. The app reads the same .done files ol learn writes, generates timed exercises from the chapter you are reading, and grades them against a hidden rubric with a local or hosted model.

Terminal window
cd app && make init && make dev

The whole curriculum builds into one PDF — every track and topic in learning order, with the C4 architecture diagrams and Mermaid diagrams rendered inline.

  • From CI: every run produces a supersource-curriculum-pdf build artifact.

  • From a release: supersource-curriculum.pdf and the generated supersource-<path>.pdf files are attached to each GitHub Release for every course pass and role path in paths/.

  • Locally:

    Terminal window
    ./scripts/build-book.sh # -> outputs/supersource-curriculum.pdf
    ./scripts/build-book.sh --path superstar-fde # -> outputs/supersource-superstar-fde.pdf
    ./scripts/build-book.sh --help # options (--skip-mermaid, --no-toc, ...)

    Requires pandoc and a LaTeX engine (xelatex). For full fidelity also install librsvg (embeds the C4 SVGs) and mermaid-filter (renders Mermaid); without them the build still succeeds with diagrams shown as code.

Company-specific guides for 19 companies. See interviews/README.md.

The tracks above are the learning path: you read them. practice/ is the practice path: it tells you whether you actually know it. One CLI drives it, and everything you write goes to a gitignored .scratchpad/, never into the repo.

Terminal window
practice/bin/ol list # every exercise, and which you have started
practice/bin/ol start predict go 01 # clone it into .scratchpad/ and open it
practice/bin/ol check predict go 01 # exit code is the verdict

Three kinds of exercise, distinguished only by what you produce:

KindYou produceIt is wrong when
predictThe exact output you expect from a snippetYour prediction differs from what ran
buildAn implementation from scratchThe exercise’s own assertions fail
reattemptA second solution to something you already solvedThe original’s assertions fail

Predict-then-run is the retention drill and the place to start: 24 snippets across Go, Rust, Python, and TypeScript where you write the exact expected output before running, and the diff tells you which part of your mental model is wrong. Every snippet is checked in CI for determinism, wall time, and peak memory.

Build is 10 graded exercises per language, covering data structures, algorithms, concurrency, and language-specific idioms. Each reference implementation is standard library only and passes its own assertions in CI.

LanguagesFocus
CoreGo, Rust, Python, TypeScript, C, C++What the curriculum targets, and what CI verifies
OptionalZig, Scala, JavaWorth doing, but not in use here; excluded from the default run

Real builds, generalized. Each takes a system designed under a deadline, strips it to the transferable concepts, and records the order it was actually assembled in. Every implementation is standard library only and runs its own tests: python <file>.py. See case-studies/README.md.

#StudyWhat it teachesRunnable
01Order Book MatchingTwo orderings, two structures; earning a heap then a tick-indexed ladder via BUDmatching_engine.py
02Grounded SQL AgentSchema grounding measured by ablation, bounded self-correction, a deterministic safety gatesafety_gate.py
03Exactly-Once Event APIConstraint-based dedup, atomic claims, and what at-most-once actually buysevent_api.py
04K-Means OptimizationInitialization over iteration, and stating an optimization’s regimekmeans_ladder.py
05Agent Evaluation HarnessOutcome, evidence, and grade kept apart; replay before grading; a checker proved by oracles and mutantseval_harness.py

See the source register for author/publisher evidence and the distinction between free books, course materials, and paid companions. Mathematics for Machine Learning connects the foundational math tracks to regression, PCA, and optimization.

All primary textbooks are free. Recommended (non-free) books are listed separately.

BookTrackLink
OpenStax Calculus Volumes 1-3Mathopenstax.org
Book of Proof by HammackMathFree PDF
Discrete Mathematics: An Open Introduction by LevinMathFree online
Linear Algebra by HefferonMathFree PDF
Introduction to Probability by Grinstead & SnellMathFree PDF
Competitive Programmer’s Handbook by LaaksonenCompetitive ProgrammingFree PDF
Introduction to Statistical Learning (ISLR)ML/AIFree online
Elements of Statistical Learning (ESL)ML/AIFree PDF
Deep Learning by Goodfellow, Bengio, CourvilleML/AIFree online
RL: An Introduction by Sutton & BartoML/AI (RL)Free online
OpenAI Spinning Up in Deep RLML/AI (RL)Free online
Machine Learning Systems by ReddiML/AI (LLM Systems)Free online
AI Engineering companion (aie-book) by HuyenML/AI (Foundation Models)Free on GitHub
Stanford CRFM Foundation Models reportML/AI (Foundation Models)Free PDF
The Data Engineering Cookbook by KretzData EngineeringFree on GitHub
Info Theory, Inference, & Learning by MacKayInformation TheoryFree online
Programming Language Foundations in Agda (PLFA) by Wadler et al.Programming LanguagesFree online
Software Foundations (Vol. 1-2) by Pierce et al.Programming LanguagesFree online
Software Engineering at Google by Winters, Manshreck, WrightSoftware CraftsmanshipFree online
Google SRE BookSystemsFree online
System Design PrimerSystemsFree on GitHub
The C4 model by Simon BrownDiagramming & DocumentationFree online
Diátaxis documentation frameworkDiagramming & DocumentationFree online
Google Technical Writing CoursesDiagramming & DocumentationFree online
Kubernetes DocumentationInfrastructure / SystemsFree online
Apache Kafka DocumentationInfrastructure / Data EngineeringFree online
Apache Lucene & Elasticsearch GuideInfrastructureLucene / ES Guide
PyTorch / JAX / vLLM DocumentationAI Platform EngineeringPyTorch / JAX / vLLM
gRPC + Protocol Buffers DocumentationAI Platform Engineeringgrpc.io / protobuf.dev
MDN Server-Sent Events + WHATWG HTML specAI Platform EngineeringMDN / Spec
Temporal / DBOS / Cassandra / Apache AGE DocsAI Platform EngineeringTemporal / DBOS / Cassandra / AGE
Redis DocumentationAI Platform EngineeringFree online
RAG paper + BM25 review + pgvectorAI Platform EngineeringRAG / BM25 / pgvector
NIST RBAC/ABAC/NGAC + Google ZanzibarAI Platform EngineeringNIST / Zanzibar
HELM + lm-evaluation-harness + RagasAI Platform EngineeringHELM / harness / Ragas
llama.cpp + GGUF + OllamaAI Platform Engineeringllama.cpp / GGUF / Ollama
Ray (Core / Train / Serve) DocumentationAI Platform EngineeringFree online
NVIDIA TensorRT-LLM + Triton Inference ServerAI Platform EngineeringTensorRT-LLM / Triton
Mistral 7B / Mixtral / Mamba papersAI Platform EngineeringMistral 7B / Mixtral / Mamba
BookTrackWhy
Introduction to Algorithms (CLRS) 4th ed.AlgorithmsThe definitive algorithms reference, formal proofs and correctness
Types and Programming Languages (TAPL) by PierceProgramming LanguagesThe definitive type-systems text: lambda calculus, System F, subtyping, inference
The Pragmatic Programmer by Hunt & Thomas (20th Anniversary)Software CraftsmanshipThe foundational text on professional software development
Designing Data-Intensive Applications by KleppmannSystems / Data EngineeringThe industry bible for distributed systems
Fundamentals of Data Engineering by Reis & HousleyData EngineeringThe definitive lifecycle-oriented introduction
The Data Warehouse Toolkit by KimballData EngineeringThe canonical text on dimensional modeling
Streaming Systems by Akidau et al.Data EngineeringThe Dataflow model that unifies batch and streaming
Designing Machine Learning Systems by HuyenML/AIProduction ML from data to deployment and serving
AI Engineering by Chip Huyen (2025)ML/AIOptional paid book; the linked official repository provides free companion materials
ByteByteGo System DesignSystemsVisual system design walkthroughs
Software Architecture Patterns by RichardsSystemsConcise pattern catalog for architecture decisions
Cloud Native DevOps with Kubernetes 2nd ed.SystemsHands-on K8s from dev through production
Observability Engineering by Majors et al.SystemsModern observability beyond the three pillars
Probability & Statistics for Engineering by DevoreMathRigorous engineering-focused probability
A Student’s Guide to Coding and Information TheoryInformation TheoryAccessible introduction with worked examples
Neo4j Graph AlgorithmsAlgorithms (Graphs)Applied graph algorithms at scale

This repo’s conventions are available as portable agent skills in skills/.

Apache-2.0