skyzh/tiny-llm

learn LLM inference system on Apple Silicon for systems engineers: build a tiny vLLM + Qwen

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 8 minutes ago
Added to GitGenius on September 15th, 2026
Created on April 19th, 2025
Open Issues & Pull Requests: 8 (+0)
GitHub issues: Enabled
Number of forks: 382
Total Stargazers: 4,565 (+0)
Total Subscribers: 32 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 21.7 hours
Mean response time: 10.6 days
90th percentile: 21.7 days
Tracked items: 19

Most active contributors

Sign in to see contributor activity.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 7
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 276 days
Stale 30+ days: 7
Stale 90+ days: 6

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

No label distribution available yet.

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

tiny-llm is a hands-on course that teaches LLM inference system design to systems engineers by building a minimal serving system for the Qwen model on Apple Silicon.

The course addresses the gap between understanding LLM fundamentals and grasping the systems-level details of production inference. Rather than using high-level abstractions, students implement operators and serving machinery from first principles using MLX arrays and Metal kernels. The learning path progresses from basic matrix operations and model components like attention and RoPE through KV-cache optimization, continuous batching, and paged KV layouts, culminating in a coding agent that demonstrates practical serving patterns. By keeping implementations small and readable, the course connects mathematical operations directly to memory traffic, kernel occupancy, and scheduling decisions.

This course suits systems engineers who want to understand inference end to end without relying on expensive GPU infrastructure. Apple Silicon provides a practical local environment with shared memory and direct Metal access, while Qwen3-4B is large enough to expose real performance constraints yet small enough to iterate on a single machine. The course structure mirrors educational projects like CMU's Needle, positioning itself as a serving-focused counterpart to foundational ML systems courses.

Development activity shows steady progression through a structured curriculum. The course is published incrementally with reviewed checkpoints rather than as a complete release, with early weeks covering core inference mechanics and later weeks introducing scheduling and agent patterns. Implementation is split between student exercises in the main package and reference solutions that serve as correctness oracles and performance baselines. The project maintains a published book alongside code, with chapter readiness tracked explicitly.