MoBA

把长文本切成块,只盯重点,让大模型轻松读百万字。

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

项目预览

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

项目数据

分类开源模型
开发团队MoonshotAI
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型flash-attention,llm,llm-serving,llm-training,moe,pytorch,transformer
GitHub 星标★ 2198
上线时间2025-02-17 00:00:00
代码更新2025-04-03
仓库体积2.5 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数6

项目介绍

MoBA 是一种面向长上下文大语言模型的新型注意力机制,核心思想是将输入序列划分为多个块,并采用混合专家(MoE)的思路,让每个查询只关注最相关的少数块,从而将标准注意力机制的二次方计算复杂度降低到接近线性。它解决了长文本处理中计算和内存开销过大的问题,使模型能够高效处理百万级 token 的上下文。MoBA 的核心能力包括:动态块选择、稀疏注意力计算、与现有 Transformer 架构无缝集成,以及支持预训练和微调。通过实验验证,MoBA 在保持模型性能的同时,显著提升了长上下文场景下的训练和推理速度,为长文本应用提供了更经济的解决方案。

Star 增长趋势

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

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

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:高级 约 30 分钟 部署方式:库/依赖 3 步

环境要求

  • Python 3.10(README 使用 conda 创建 python=3.10 环境)
  • torch >= 2.1.0
  • flash-attn==2.6.3(当前 kernel 实现依赖该版本)
  • conda 环境管理工具
  • 可访问的 Llama-3.1-8B 模型权重(需自行准备)

安装与启动步骤

  1. 1创建并激活环境

    使用 conda 创建 Python 3.10 的独立环境,避免与现有依赖冲突,随后激活该环境。

    conda create -n moba python=3.10
    conda activate moba
  2. 2安装 MoBA

    在项目根目录执行 pip install . 完成安装,注意 README 要求 torch>=2.1.0 与 flash-attn==2.6.3。

    pip install .
  3. 3运行示例脚本

    使用 examples/llama.py 跑通快速开始,通过 --attn 选择 moba 或 moba_naive 注意力后端。

    python3 examples/llama.py --model meta-llama/Llama-3.1-8B --attn moba

关键配置

配置项必填说明示例
--model是指定要加载的模型名称或路径meta-llama/Llama-3.1-8B
--attn否选择注意力后端:moba 或 moba_naivemoba

如何确认成功

示例脚本 examples/llama.py 能正常加载模型并完成前向运行,没有报注意力后端或依赖版本错误。

常见问题

Q:MoBA 能直接用在预训练模型上加速吗?

A:不能。README 明确指出 MoBA 需要继续训练现有模型才能获得加速收益,并非即插即用的稀疏注意力方案。

Q:--attn 可选哪些后端?

A:可在 moba 与 moba_naive 之间选择,分别对应优化的 MoBA 实现和朴素实现。

Q:安装时对版本有什么要求?

A:当前 kernel 实现依赖 flash-attn==2.6.3 和 torch>=2.1.0,版本不符可能导致安装或运行失败。

注意事项

  • MoBA 需要继续训练已有模型才能体现加速效果,不是直接替换全注意力即可生效的方案。
  • 安装前请确认 torch 与 flash-attn 版本符合 README 要求,避免编译或运行报错。
  • 示例中的 meta-llama/Llama-3.1-8B 需要本地已具备访问权限或已下载的权重。

核心亮点

  • 计算复杂度从二次方降到近线性,长文本处理速度大幅提升
  • 采用 MoE 思路动态选择关键块,注意力聚焦更精准
  • 与现有 Transformer 架构兼容,可直接替换标准注意力模块

不足之处

  • 块选择机制可能引入额外开销,对短文本优势不明显
  • 文档/社区待观察

适用场景

  • 长文档问答与摘要
  • 代码库级上下文理解
  • 多轮长对话记忆增强

替代项目

Longformer、BigBird、Sparse Transformer

上一篇:Bonsai-demo

下一篇:magicoder

同类项目推荐

StarWhisper 开源

用自然语言指挥望远镜,让天文观测像聊天一样简单

Astronomy LLMs, StarWhisper Telescope, Virtual Sitian, and astronomy research skills

★ 331 2026-08-09
RETFound 开源

拿医学影像直接预训练,少标注也能做AI诊断

Vision Foundation Models for Medical AI, including RETFound, DINOv2, DINOv3

★ 693 2026-08-09
GPT-Models-Plus 开源

一个脚本搞定 ChatGPT、Claude、Grok 多模型调用

别问我为什么大杂烩放在一块,懒得新建项目

★ 126 2026-08-09
Awesome-LLM-Ensemble 开源

一页看尽LLM集成研究,快速定位核心论文

A curated list of Awesome-LLM-Ensemble papers for the survey "Harnessing Multiple La···

★ 258 2026-08-09
RWKV-LM 开源

用 RNN 的速度跑出 GPT 的效果,长上下文不再烧显存

RWKV (pronounced RwaKuv) is an RNN with great LLM performance, which can also be dir···

★ 14771 2026-08-09
NLP-pretrained-model 开源

收集常用NLP预训练模型,拿来即用省训练时间

A collection of Natural language processing pre-trained models.

★ 169 2026-08-09
Qwen3.8 开源

开源大模型,本地部署即可对话推理写代码

Qwen3.8 is the large language model series developed by Qwen team, Alibaba Group.

★ 4399 2026-09-15
nlp_xiaojiang 开源

中文NLP一站式工具箱,开箱即用搞定相似度、NER和数据增强

自然语言处理(nlp),小姜机器人(闲聊检索式chatbot),BERT句向量-相似度(Sentence Si···

★ 1533 2026-08-09