continuous batching、RAM/SSDの階層型KVキャッシュ、メニューバーからの管理に対応した、Apple Silicon Mac向けのLLM推論サーバー。
skyzh/tiny-llm
システムエンジニア向けの実践コース。Apple Silicon上でMLXを使い、matmulからミニvLLMやコーディングエージェントまで、小規模なQwen3 LLM推論スタックを構築します。
- スター
- 5,675
- フォーク
- 522
- 未解決の Issue
- 12
- 最終コミット
- 昨日
これは何?
tiny-llmは、LLM推論をエンドツーエンドで理解したいシステムエンジニア向けのコースです。受講者は、Qwen3モデルを読み込み、トークンをlogitsに変換してテキストを生成するまでの処理を実装します。MLXの配列演算から始め、モデルの要件に応じてカーネルやサービング機構を追加していきます。
このコースでは、MLXの配列とMLX extension runtimeを基盤とし、高水準のニューラルネットワークレイヤーは使いません。各章で演算子を扱う際は、学習者がPython、C++、またはMetalで実装します。その間、MLXは正しさを検証する基準と、性能比較のベースラインとして機能します。コード全体を読めるよう、規模は小さく保たれています。
4週間のカリキュラムでは、KV cacheと量子化重みを使う単一リクエストモデル、continuous batching、chunked prefill、paged KV cacheを備えたミニvLLM、そして検証済みの編集と再開可能なチェックポイントを備えた、段階的に構築するWeek 4のコーディングエージェントを扱います。対象はApple Silicon搭載マシンで、書籍はオンラインで公開されており、テスト用のリファレンス実装パッケージも付属します。
主な機能
- 01attention、RoPE、GQA、RMSNormなどを含むMLXの配列演算を使ってQwen3モデルを構築
- 02KV cache、量子化matvec、融合カーネルをPython、C++、またはMetalで実装
- 03ミニvLLMでcontinuous batching、chunked prefill、paged KV cacheを学習
- 04各章の確認に使えるリファレンス実装とテストスイートを収録
- 05検証済みの編集と再開可能なチェックポイントを備えたコーディングエージェントを段階的に構築
ユースケース
- LLM推論の数式とメモリトラフィックやKV cacheの増加との関係を理解したいシステムエンジニア
- vLLM方式のバッチ処理やpaged attentionの内部動作を学びたい開発者
- Apple Silicon搭載Macでローカルモデルの実験を行うエンジニア
クイックスタート
- 1
書籍の環境構築ガイドを読む
- 2
PDMで依存関係をインストールする
pdm install -v - 3
インストールを確認する
pdm run check-installation - 4
Week 1の参照ソリューションのテストを実行する
pdm run test-refsol -- -- -k week_1
使う前に知っておきたいこと
- このコースはMLXを基盤としており、Apple silicon搭載のMac向けに設計されています。
- Week 2とWeek 4の章は現在も制作中で、すべてが完成しているわけではありません。
- Week 4のコーディングエージェントはコマンドの実行やファイルの編集ができるため、秘密情報のない使い捨てのワークスペースを使用してください。
収録されている特集
トピック
よくある質問
- tiny-llm とは?
- システムエンジニア向けの実践コース。Apple Silicon上でMLXを使い、matmulからミニvLLMやコーディングエージェントまで、小規模なQwen3 LLM推論スタックを構築します。 tiny-llmは、LLM推論をエンドツーエンドで理解したいシステムエンジニア向けのコースです。受講者は、Qwen3モデルを読み込み、トークンをlogitsに変換してテキストを生成するまでの処理を実装します。MLXの配列演算から始め、モデルの要件に応じてカーネルやサービング機構を追加していきます。
- tiny-llm は無料で使えますか?ライセンスは?
- tiny-llm は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- tiny-llm は今もメンテナンスされていますか?
- 活発にメンテナンス中。tiny-llm の最終コミットは 2026年11月6日 です。
- tiny-llm は何に使えますか?
- LLM推論の数式とメモリトラフィックやKV cacheの増加との関係を理解したいシステムエンジニア vLLM方式のバッチ処理やpaged attentionの内部動作を学びたい開発者 Apple Silicon搭載Macでローカルモデルの実験を行うエンジニア
- tiny-llm のインストール方法は?
- 書籍の環境構築ガイドを読む PDMで依存関係をインストールする: pdm install -v インストールを確認する: pdm run check-installation Week 1の参照ソリューションのテストを実行する: pdm run test-refsol -- -- -k week_1
- tiny-llm はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/skyzh/tiny-llm
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
Apple Silicon向けのセルフホスト型MLX推論サーバー。LLM、VLM、画像生成でOpenAI、Anthropic、Ollama互換APIを利用できます。
Apple Silicon上でMLXを使い、1枚の画像に対する候補回答を採点する視覚言語モデル推論の学習用プロジェクト。
iPhoneをUSB-CでMacに接続し、GPUを活用してQwen 27Bをローカル実行。プロンプト処理を高速化し、コンテキストを拡張します。
学習済みルーティング予測を使い、SSDからエキスパートの重みをストリーミングして、一般向けデバイスで大規模なSparse MoEモデルを動かすオープンソースフレームワーク。
Apple silicon上でMLXモデルを実行するLLM推論エンジン。LM Studioのバックエンドとして使われます。