mixtral-offloading

让 8x7B 大模型在低配电脑上跑起来

mixtral-offloading 是一个让 Mixtral-8x7B 大模型在消费级硬件(如 Colab 免费版或个人桌面)上运行的工具。它通过智能的层卸载和量化技术,将模型权重分配到 CPU 和 GPU 内存中,并利用 bitsandbytes 进行 4-bit 量化,大幅降低显存需求。项目解决了普通用户因显存不足而无法运行大型 MoE 模型的问题,核心能力包括:自动检测 GPU 显存并动态调整卸载策略、支持 Hugging Face 模型下载、提供简单的 Python API 和命令行接口。用户无需高端显卡,即可体验 8x7B 模型的强大能力,适合研究、教学和个人实验。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 2335
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类开源模型
开发团队dvmazur
所属国家
官网地址
定价模式free
价格说明开源项目,MIT许可证,完全免费,可自行部署运行Mixtral-8x7B模型。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型colab-notebook,deep-learning,google-colab,language-model,llm,mixture-of-experts,offloading,pytorch,quantization
GitHub 星标★ 2335
30天Star增速
HF 下载量
上线时间2023-12-15 00:00:00
最近更新2026-09-23 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

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

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

环境要求

  • 能访问 GitHub 与 Hugging Face 的网络环境
  • 拥有 GPU 的机器(如 Colab 免费版)或可在本地运行 Jupyter Notebook
  • 足够的磁盘空间用于下载 Mixtral-8x7B 模型权重
  • Python 环境(README 未给出具体版本与依赖清单)

安装与启动步骤

  1. 1运行 Colab 演示

    README 推荐的首选方式:直接打开官方 Colab 链接,无需本地环境,按提示复制笔记本并逐格执行。

  2. 2克隆项目仓库

    如需本地运行,先把仓库克隆到本地,得到包含 demo.ipynb 的项目目录。

    git clone https://github.com/dvmazur/mixtral-offloading.git
  3. 3打开演示笔记本

    用 Jupyter 打开仓库中的 notebooks/demo.ipynb,这是 README 中唯一提供的运行入口。

    jupyter notebook notebooks/demo.ipynb
  4. 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

项目介绍

mixtral-offloading 是基础设施领域的开源项目,由 dvmazur 开发,2023 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(2,335)位列前 30%,在基础设施分类中处于中上游。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-23。MIT许可证,完全免费,可自行部署运行Mixtral-8x7B模型。

它主要面向的使用场景是:在Colab或低配笔记本上运行Mixtral-8x7B进行文本生成。同类可对比的替代方案包括 llama.cpp、exllama、GPTQ-for-LLaMa。

上一篇:yek

下一篇:openlake

同类项目推荐

freebuff-proxy 开源

聚合多账号,一键接入 OpenAI 兼容 API,轻松管理会话。

Multi-account OpenAI-compatible gateway for coding models. Pooled keys, session life···

★ 213 2026-08-20
microduck 开源

用 Rust 造一只会走路的桌面小鸭,快速上手双足机器人。

A Tiny biped duck robot

★ 8684 2026-09-10
soperator 开源

用 Kubernetes 原生方式运行 Slurm,简化 HPC 集群管理。

Run Slurm in Kubernetes

★ 439 2026-08-10
ollama 开源

一条命令本地跑起大模型,免费、私密、不卡顿

Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other···

★ 181484 2026-08-09