
mixtral-offloading
让 8x7B 大模型在低配电脑上跑起来
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2334
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- 能访问 GitHub 与 Hugging Face 的网络环境
- 拥有 GPU 的机器(如 Colab 免费版)或可在本地运行 Jupyter Notebook
- 足够的磁盘空间用于下载 Mixtral-8x7B 模型权重
- Python 环境(README 未给出具体版本与依赖清单)
安装与启动步骤
-
1运行 Colab 演示
README 推荐的首选方式:直接打开官方 Colab 链接,无需本地环境,按提示复制笔记本并逐格执行。
-
2克隆项目仓库
如需本地运行,先把仓库克隆到本地,得到包含 demo.ipynb 的项目目录。
git clone https://github.com/dvmazur/mixtral-offloading.git -
3打开演示笔记本
用 Jupyter 打开仓库中的 notebooks/demo.ipynb,这是 README 中唯一提供的运行入口。
jupyter notebook notebooks/demo.ipynb -
4按单元格执行
依次运行 notebook 中的单元格完成模型加载与推理;README 未提供依赖安装清单,缺失库请按报错补装。
如何确认成功
notebook 单元格全部执行无报错,并能成功加载 Mixtral-8x7B 并输出生成文本。
常见问题
Q:有可以本地直接运行的命令行脚本吗?
A:README 明确说明目前没有本地运行的命令行脚本,只能用 demo notebook;可参考该 notebook 自行编写脚本,项目也欢迎贡献。
Q:显存不够能跑吗?
A:项目通过 HQQ 混合量化与 MoE 卸载把专家分布到 CPU 和 GPU 内存中,降低显存需求;README 未提供可调参数说明,具体请参考 notebook。
Q:支持哪些模型?
A:README 只说明支持 Mixtral-8x7B 系列模型的高效推理,未提及其他模型。
Q:技术报告里的方法都能用吗?
A:README 说明技术报告中的部分技术尚未在本仓库实现,作者正在陆续补充,请以仓库现状为准。
注意事项
- README 未提供 pip 安装命令、依赖清单、端口或配置文件说明,本教程步骤均为可推断的通用准备动作。
- 唯一官方运行入口是 demo notebook 和 Colab 链接,不要自行假设存在 CLI 脚本。
- 模型权重体积较大,下载与加载耗时较长,请预留磁盘与网络时间。
核心亮点
- 显存占用降低 80% 以上,4-bit 量化让 8x7B 模型在 8GB 显存下可运行
- 自动卸载层到 CPU 内存,无需手动配置,开箱即用
- 支持 Colab 免费版,零成本体验顶级开源模型
不足之处
- 推理速度较慢,CPU 卸载导致延迟明显
- 文档/社区待观察
适用场景
- 在 Colab 或低配笔记本上运行 Mixtral-8x7B 进行文本生成
- 教学演示 MoE 模型架构和量化推理
- 个人开发者在无 GPU 环境下测试模型效果
替代项目
llama.cpp、exllama、GPTQ-for-LLaMa
同类项目推荐
UnifiedModel
开源
一次建模,让 AI 智能体秒懂企业数据
The semantic layer that makes enterprise data understandable to AI agents — model e···
cognitive-workspace
开源
让 LLM 拥有无限上下文,长任务不再失忆
Active memory management system enabling functional infinite context for LLMs throug···
modal-examples
开源
一键跑通云端 GPU 任务,从示例到生产部署
Examples of programs built using Modal
spark-local-inference
开源
Rust 写的本地大模型推理服务底座,请求调度一把抓
symforce
开源
写符号公式,自动生成机器人实时优化代码
Fast symbolic computation, code generation, and nonlinear optimization for robotics
tool-journal
开源
让工具重试不再重复执行,崩溃后也能安全恢复
TypeScript execution journal for retryable tools: SQLite durability, lease fencing, ···
terraform-aws-metaflow
开源
用 Terraform 在 AWS 上快速搭建生产级 Metaflow 环境
Deploy production-grade Metaflow cloud infrastructure on AWS
guardian-db
开源
本地优先、点对点同步的 Rust 去中心化数据库
GuardianDB: High-performance, local-first decentralized database that stores and pro···
ploomber
开源
像写 Notebook 一样快速构建数据管道,一键部署上云。
The fastest ⚡️ way to build data pipelines. Develop iteratively, deploy anywhere. ···