makeMoE

手写稀疏混合专家模型,彻底搞懂 MoE 原理

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 96 🐛 待处理 3 👀 关注 5
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 821
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,需自行部署使用。

项目预览

makeMoE 项目界面预览图
图片来源:项目官网

项目数据

分类开源模型
开发团队AviSoori1x
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,需自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Jupyter Notebook
技术栈/模型deep-learning,large-language-models,llm,mixture-of-experts,neural-networks,pytorch,pytorch-implementation
GitHub 星标★ 821
上线时间2024-01-22 00:00:00
代码更新2024-10-30
仓库体积7.1 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数4

项目介绍

makeMoE 是一个从零开始实现稀疏混合专家(MoE)语言模型的教学项目,灵感来源于 Andrej Karpathy 的 makemore。它通过 Jupyter Notebook 形式,逐步拆解 MoE 模型的构建过程,包括专家网络、门控机制、负载均衡损失等核心组件。项目旨在帮助深度学习开发者深入理解 MoE 的内部工作原理,而非提供生产级模型。它解决了现有教程中 MoE 实现复杂、难以入门的问题,用清晰的代码和注释展示每个细节。核心能力包括:稀疏门控的前向传播、专家选择与路由、以及简单的训练循环。适合作为学习 MoE 架构的起点,尤其适合已有基础神经网络知识、想进阶到混合专家模型的开发者。

Star 增长趋势

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

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

使用教程

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

环境要求

  • Python 3.10+
  • PyTorch
  • 单卡即可

安装与启动步骤

  1. 1克隆

    从零实现 MoE 的教学仓库。

    git clone https://github.com/AviSoori1x/makeMoE.git
    cd makeMoE
  2. 2装依赖

    torch 为主,单卡即可。

    pip install torch numpy
  3. 3跑训练

    小语料上验证路由与负载均衡。

    python train.py
  4. 4看专家分布

    检查各专家是否被均匀使用。

    # 打印 routing 统计

如何确认成功

训练后各专家激活次数没有严重倾斜。

注意事项

  • 配套有 HuggingFace 博客逐步讲解,先读再跑。
  • 专家塌缩是 MoE 最常见的坑,看路由分布。
  • 教学规模小,别拿来直接训大模型。

核心亮点

  • 从零手写,无黑盒依赖,代码透明易读
  • 聚焦 MoE 核心机制,门控和负载均衡讲解清晰
  • Notebook 形式,可交互运行,适合边学边练

不足之处

  • 仅教学用途,不适用于实际生产任务
  • 文档和社区支持有限,扩展内容较少

适用场景

  • 学习 MoE 架构原理,动手实现加深理解
  • 作为课程或工作坊的实战教材
  • 研究稀疏模型时快速验证想法

替代项目

makemore、Mixtral-8x7B、Switch Transformer

上一篇:llm-mcts

下一篇:ETO

同类项目推荐

get_model 开源

模块化建模跨细胞类型转录调控,多模态数据一键训练

A modular framework for multimodal cross-cell-type transcriptional regulation models

★ 114 2026-08-09
self-llm 开源

手把手教你微调部署开源大模型,中文教程一步到位

《开源大模型食用指南》针对中国宝宝量身打造的基于Linux环境快速微调(全参数/Lora)、部···

★ 32733 2026-08-09
azure-databricks-mlops-mlflow 开源

在 Azure Databricks 上快速搭建不依赖 MLflow Project 的 MLOps 流程

Azure Databricks MLOps sample for Python based source code using MLflow without usin···

★ 97 2026-08-09
shortened-llm 开源

压缩LLM,推理提速,显存减半,生成依旧流畅。

Compressed LLMs for Efficient Text Generation [ICLR'24 Workshop]

★ 91 2026-08-09
PRIME 开源

让大模型学会深度推理,强化学习训练一步到位

Scalable RL solution for advanced reasoning of language models

★ 1873 2026-08-09
ZO-LLM 开源

用零阶优化在低显存下微调大模型,省内存不省效果

[ICML‘24] Official code for the paper "Revisiting Zeroth-Order Optimization for Mem···

★ 131 2026-08-09
transformer-tricks 开源

查Transformer加速技巧,少走弯路,直接上手

A collection of tricks and tools to speed up transformer models

★ 236 2026-08-09
raft 开源

微调+RAG双阶段,让AI代理精准模仿特定人物

RAFT, or Retrieval-Augmented Fine-Tuning, is a method comprising of a fine-tuning an···

★ 178 2026-08-09
PERSIA 开源

多机并行训练大规模推荐模型

High performance distributed framework for training deep learning recommendation mod···

★ 410 2026-10-31