github.com·2026/10/24·JustVugg
colibri 是本地 MoE 推理引擎,让无 GPU 的普通 CPU、RAM 和磁盘机器运行 744B 级 GLM:dense 权重常驻 RAM,routed experts 留在磁盘,按 router 需求读取,并用缓存与预取学习热专家。它用纯 C 单文件引擎支持 GLM、Kimi、DeepSeek、Qwen、图像与决策模型,通过 START-HERE 脚本检测硬件、推荐模型、构建或下载引擎、续传权重并启动仪表盘及 OpenAI/Anthropic API;每层执行路由、合并、定位、重叠与学习,热专家可升入 RAM 或显存,System One 端点输出可阈值化概率。CPU、Vulkan、CUDA、Metal 只改变权重放置,不改变路由与精度;官方称该模型在多张 NVIDIA 卡可达 9.0-9.2 tok/s,最低 8 GB RAM 可从小模型起步。项目以 Apache 许可发布且标为 Beta,瓶颈是磁盘带宽,部分模型需转换并遵守各自许可。
为什么重要 MoE 模型部署不再依赖大显存集群;对数据闭环工程师意味着可在本地工作站跑千亿级模型做标注/评估适合 需要在本地/边缘跑大 MoE 做离线推理、标注、评测的基础设施工程师
25 GB 笔记本冷启
全部专家走磁盘
128 GB CPU
Ryzen AI Max+ 395
6×RTX 5090
全专家驻留+NUMA
路由前瞻命中
一层 ahead 可预测
注释 · 官方报告;同一引擎与容器,仅硬件/驻留策略不同出自 §Benchmarks
注释 · 机器 A:Ryzen 7 PRO 8700GE,64 GB DDR5,100 tokens 解码出自 §GPUs·Vulkan
每模型族一个 .c 引擎 + 共享头文件
Vulkan 计算着色器
无依赖 C/Python 测试
模型转换与基准测试工具
Python 包:CLI、setup、API 网关
参考文档、实验记录、基准表
Dashboard 前端(纯 API 客户端)
顶层构建入口,委托引擎 Makefile
$ sudo apt install git python3 build-essential && git clone https://github.com/JustVugg/colibri && cd colibri
$ ./start-here.sh
$ ./coli chat --model /nvme/qwen36
$ ./coli serve --model /nvme/qwen36
EVIDENCE / METHODS
流程
稠密层驻 RAM,路由专家留磁盘按需 pread,LRU+学习缓存逐步升温
路由器决定本 token 需要哪些专家
合并同 batch 各 position 的专家需求,每个专家只读一次
按测量热度决定专家放 VRAM / RAM / 磁盘;.coli_usage 记录历史
加载线程预取缺失专家,常驻专家同时计算;router-lookahead 预取下一层
每轮更新 .coli_usage,pinned hot set 随使用自适应
注释 · 放置只影响速度,不改变路由决策与权重精度出自 §How it works