C++ 和 Python 推理库,通过量化和优化内核,更快、更省内存地运行 Whisper、Llama、NLLB 等 Transformer 模型。
FareedKhan-dev/kimi-k3-in-c
用可移植 C99 实现的推理引擎,在单颗 CPU 上运行 2.78 万亿参数的 Kimi K3,无需 GPU 或 BLAS。
- Star
- 10,896
- Fork
- 1,702
- 未关闭 Issue
- 4
- 最近提交
- 上个月
这是什么?
kimi-k3-in-c 是 Kimi K3 混合专家模型的推理引擎,使用可移植的 C99 编写,不依赖 BLAS、框架或 GPU。模型权重在磁盘上约 1.56 TB,但每层 896 个路由专家中每个 token 只激活 16 个,因此引擎把稠密主干常驻内存,其余专家从磁盘按需流式读取。项目给出的峰值常驻内存为 8.24 GB,不同内存预算下输出逐字节一致,内存越多只会让生成越快。
引擎覆盖完整流程:safetensors 读取、配置解析、与官方一致的分词器、MXFP4 专家计算内核、KDA 与 MLA 注意力、专家 LRU 缓存,以及使用官方 XTML 格式的多轮对话模式。部署需要下载权重、把主干打包成单个文件,再选择内存预设。测试套件可以在小模型上与 PyTorch 参考实现逐项比对,无需完整权重。
这个项目适合希望在普通硬件上研究或运行超大 MoE 模型的开发者,也可作为底层推理设计的参考实现。生成速度受磁盘吞吐限制,本地 NVMe 硬盘影响很大。
核心功能
- 01在单颗 CPU 上运行 2.78 万亿参数的 Kimi K3,峰值内存约 8 GB。
- 02将路由专家从磁盘流式读取,并用 LRU 缓存保留高频专家。
- 03使用 MXFP4 内核,以及 AVX2 或 NEON 的 SIMD 路径,不依赖 BLAS。
- 04在各个内存预算下输出逐字节一致。
- 05支持基于官方 XTML 格式与分词器的多轮文本对话。
- 06提供测试套件,可与 PyTorch 参考实现比对输出。
适用场景
- 在没有 GPU 的笔记本或台式机上运行超大规模 MoE 模型。
- 学习混合专家模型的流式推理,以及 KV 缓存和循环状态在 C 语言中的实现方式。
- 在为其他大模型开发 CPU 推理引擎时,将其作为参考实现。
- 评估存储吞吐对 CPU 端大模型生成速度的限制。
快速上手
- 1
克隆仓库
git clone https://github.com/FareedKhan-dev/kimi-k3-in-c.git - 2
进入项目目录
cd kimi-k3-in-c - 3
编译引擎
make -j - 4
运行测试套件(无需模型权重)
make test
使用前须知
- 运行完整模型需要磁盘上有 1.56 TB 的模型权重,总共约需 1.7 TB 可用空间。
- 在小内存机器上生成非常慢,8 GB 内存下每个 token 约需 26 秒。
- 聊天模式和完整模型需要另行下载庞大的官方模型权重。
收录于专题
标签
常见问题
- kimi-k3-in-c 是什么?
- 用可移植 C99 实现的推理引擎,在单颗 CPU 上运行 2.78 万亿参数的 Kimi K3,无需 GPU 或 BLAS。 kimi-k3-in-c 是 Kimi K3 混合专家模型的推理引擎,使用可移植的 C99 编写,不依赖 BLAS、框架或 GPU。模型权重在磁盘上约 1.56 TB,但每层 896 个路由专家中每个 token 只激活 16 个,因此引擎把稠密主干常驻内存,其余专家从磁盘按需流式读取。项目给出的峰值常驻内存为 8.24 GB,不同内存预算下输出逐字节一致,内存越多只会让生成越快。
- kimi-k3-in-c 可以免费使用吗?用的什么许可证?
- kimi-k3-in-c 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
- kimi-k3-in-c 还在维护吗?
- 半年内有更新。kimi-k3-in-c 最近一次提交是在 2026年10月2日。
- kimi-k3-in-c 适合用来做什么?
- 在没有 GPU 的笔记本或台式机上运行超大规模 MoE 模型。 学习混合专家模型的流式推理,以及 KV 缓存和循环状态在 C 语言中的实现方式。 在为其他大模型开发 CPU 推理引擎时,将其作为参考实现。 评估存储吞吐对 CPU 端大模型生成速度的限制。
- kimi-k3-in-c 怎么安装和运行?
- 克隆仓库: git clone https://github.com/FareedKhan-dev/kimi-k3-in-c.git 进入项目目录: cd kimi-k3-in-c 编译引擎: make -j 运行测试套件(无需模型权重): make test
- 在哪里获取 kimi-k3-in-c?
- 源代码和安装说明在 GitHub 上:https://github.com/FareedKhan-dev/kimi-k3-in-c
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
面向 Google Gemma 模型的轻量级独立 C++ 推理引擎,主要在 CPU 上运行。
用纯 Mojo 编写的单文件 Llama 2 推理实现,利用 SIMD 向量化与多线程加速。
面向大型 MoE 模型的 CPU-GPU 异构推理与微调框架,可在有限显存下运行超大模型。
在 NVIDIA Blackwell 显卡上本地运行 Qwen3.8-Flash-Next 混合专家模型的推理引擎,提供兼容 OpenAI 与 Anthropic 的 API。
基于 PyTorch 的 LLM 工具包,可预训练、微调、评估和部署 20 多种开源权重模型。