tiny-llm

在苹果芯片上从零手写一个迷你 vLLM,吃透推理服务

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 526 🐛 待处理 8 👀 关注 34
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 5692
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源课程,Apache-2.0 许可证,完全免费,可自行部署学习。

项目预览

tiny-llm 项目界面预览图
图片来源:项目官网

项目数据

分类开源模型
开发团队skyzh
定价模式🏷️完全免费
价格说明开源课程,Apache-2.0 许可证,完全免费,可自行部署学习。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型course,large-language-model,llm,python,qwen,serving,vllm
GitHub 星标★ 5692
上线时间2025-04-19 00:00:00
代码更新2026-11-07
仓库体积7.7 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数7

项目介绍

tiny-llm 是一个面向系统工程师的 LLM 推理服务实战课程,专注于在 Apple Silicon 上构建一个精简版 vLLM + Qwen。项目通过亲手实现推理服务核心组件,帮助学习者深入理解 LLM 推理的完整流程,包括张量并行、KV Cache、连续批处理等关键概念。它解决了传统教程偏重模型使用而忽视系统实现的问题,提供从零搭建的代码和文档,让学习者能真正掌握推理服务的性能优化和工程落地。核心能力包括:基于 Apple Silicon 的硬件适配、vLLM 核心机制的简化复现、以及 Qwen 模型的实际部署。适合希望从系统层面理解 LLM 推理的工程师,也适合作为学习 vLLM 内部原理的入门教材。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5692

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:入门 约 30 分钟 部署方式:本地安装 4 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • 运行环境需支持 MLX(课程基于 Apple Silicon 与 MLX 数组、MLX 扩展运行时)
  • 已安装 Python(项目开发语言为 Python)
  • 对矩阵运算、GPU kernel、LLM 推理有基础了解(课程面向系统工程师)
  • 能访问 GitHub 以获取课程代码与更新

安装与启动步骤

  1. 1克隆课程仓库

    从 GitHub 拉取 tiny-llm 课程代码到本地。README 节选未提供安装脚本或依赖清单,克隆后以仓库内文档为准。

    git clone https://github.com/skyzh/tiny-llm.git
  2. 2进入仓库目录

    切换到克隆下来的目录,查看目录结构与文档,确认各周章节的组织方式。

    cd tiny-llm
  3. 3阅读学习路径

    按 README 与官网的四周边学习路径规划:第 1 周从矩阵乘到文本生成,第 2 周加入 KV Cache 与优化。

  4. 4确认运行环境

    课程基于 MLX arrays 与 MLX 扩展运行时,不使用高层神经网络层,请在支持 MLX 的机器上学习。

如何确认成功

README 节选未给出启动命令或服务端口;能按课程完成 Week 1 的 MLX 数组与算子练习,即可认为环境就绪。

常见问题

Q:有现成的安装或启动命令吗?

A:README 节选未提供 pip 安装、启动脚本或端口说明,具体安装方式请以 GitHub 仓库最新文档与官网为准。

Q:需要 NVIDIA GPU 吗?

A:课程围绕 Apple Silicon 与 MLX 构建,讲解的是该平台上的算子实现与推理服务机制。

Q:需要先掌握 vLLM 吗?

A:不需要。课程从数组与矩阵运算起步,逐步引入 kernel、KV Cache、连续批处理等 vLLM 核心概念。

Q:学完大概要多久?

A:课程按四周学习路径组织,第 1 周搭建 Qwen3 文本生成,第 2 周起推进 KV Cache 与各类优化。

注意事项

  • README 节选只包含课程介绍与学习路径,没有安装命令、端口或配置文件信息,部署步骤请以官方仓库和官网为准。
  • 课程要求自己实现算子(Python、C++ 或 Metal),不直接调用 MLX 已优化的对应算子,MLX 仅作为正确性基准与性能基线。
  • 示例模型为 Qwen3,加载与生成过程需要按各章节说明自行编写实现。

核心亮点

  • 手写实现 vLLM 核心机制,学习曲线陡峭但收获扎实
  • 针对 Apple Silicon 优化,硬件适配性强,便于本地实践
  • 课程化设计,文档和代码配套,适合系统工程师转型

不足之处

  • 仅覆盖推理服务基础,高级特性(如量化、分布式)未深入
  • 文档/社区待观察

适用场景

  • 学习 LLM 推理服务原理,作为系统工程师的进阶课程
  • 在 Apple Silicon 设备上快速搭建轻量级推理服务
  • 作为 vLLM 源码阅读前的引导性项目

替代项目

vLLM、TinyChat、llama.cpp

上一篇:happy-llm

下一篇:generative-ai

同类项目推荐

reproducible-data-science 开源

手把手教你搭建可复现的数据科学项目,告别结果跑不出来

Tutorials on creating a reproducible and maintainable data science project

★ 153 2026-08-09
DecryptPrompt 开源

一库在手,快速读懂 LLM 与 Prompt 前沿论文

总结Prompt&LLM论文,开源数据&模型,AIGC应用

★ 3451 2026-08-09
citation-assistant 开源

在 Claude Code 里自动查文献、生成规范引用

Claude Code Skill for automated academic citation workflow with Semantic Scholar API

★ 238 2026-10-30
intro_pharma_ai 开源

给生命科学学生的可运行深度学习入门课

A collection of Jupyter Notebooks that are designed to teach life science students a···

★ 171 2026-10-21
Claw-ED 开源

命令行一键生成全套课程包,保留你的教学风格

Local-first AI teaching assistant for editable lesson drafts, student materials, and···

★ 65 2026-08-09
vibe-schooling 开源

号称不学习也能拿 4.0,看完才知道套路多深

Get 4.0 GPA without learning

★ 82 2026-08-09
ClassCue 开源

课堂语音实时转文字,点名答疑一机搞定

按课表记好每一节课、被点名时及时提醒的本地优先 Android 课堂助手:离线录音转写、点名提···

★ 102 2026-09-15
ai-ml-roadmap 开源

照着走,零基础也能系统入门AI/ML

Welcome to the ultimate guide for starting your journey in Artificial Intelligence a···

★ 90 2026-08-09
long-term-memory-in-ai 开源

普林斯顿课程讲义,系统学向量检索与向量数据库

Class notes for the course "Long Term Memory in AI - Vector Search and Databases" CO···

★ 324 2026-10-24