mixtral-offloading

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 225 🐛 待处理 26 👀 关注 27
GitHub ↗
GitHub 星标 ★ 2334
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,可自行部署运行Mixtral-8x7B模型。

项目预览

mixtral-offloading 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队dvmazur
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,可自行部署运行Mixtral-8x7B模型。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型colab-notebook,deep-learning,google-colab,language-model,llm,mixture-of-experts,offloading,pytorch,quantization
GitHub 星标★ 2334
上线时间2023-12-15 00:00:00
代码更新2024-04-08
仓库体积267 KB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数4

项目介绍

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

Star 增长趋势

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

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

使用教程

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

难度:入门 约 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

上一篇:yek

下一篇:openlake

同类项目推荐

UnifiedModel 开源

一次建模,让 AI 智能体秒懂企业数据

The semantic layer that makes enterprise data understandable to AI agents — model e···

★ 455 2026-08-09
cognitive-workspace 开源

让 LLM 拥有无限上下文,长任务不再失忆

Active memory management system enabling functional infinite context for LLMs throug···

★ 105 2026-08-09
modal-examples 开源

一键跑通云端 GPU 任务,从示例到生产部署

Examples of programs built using Modal

★ 1290 2026-08-09
symforce 开源

写符号公式,自动生成机器人实时优化代码

Fast symbolic computation, code generation, and nonlinear optimization for robotics

★ 1656 2026-09-14
tool-journal 开源

让工具重试不再重复执行,崩溃后也能安全恢复

TypeScript execution journal for retryable tools: SQLite durability, lease fencing, ···

★ 360 2026-09-18
terraform-aws-metaflow 开源

用 Terraform 在 AWS 上快速搭建生产级 Metaflow 环境

Deploy production-grade Metaflow cloud infrastructure on AWS

★ 70 2026-08-09
guardian-db 开源

本地优先、点对点同步的 Rust 去中心化数据库

GuardianDB: High-performance, local-first decentralized database that stores and pro···

★ 215 2026-08-09
ploomber 开源

像写 Notebook 一样快速构建数据管道,一键部署上云。

The fastest ⚡️ way to build data pipelines. Develop iteratively, deploy anywhere. ···

★ 3622 2026-08-09