ringattention

环形分布注意力,让长上下文处理又快又省显存

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 52 🐛 待处理 9 👀 关注 7
GitHub ↗
GitHub 星标 ★ 775
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,Apache-2.0许可,可免费使用和部署。

项目预览

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

项目数据

分类开源模型
开发团队haoliuhl
定价模式🏷️完全免费
价格说明开源项目,Apache-2.0许可,可免费使用和部署。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型large-language-models,long-context,memory-efficient,transformers
GitHub 星标★ 775
上线时间2023-06-01 00:00:00
代码更新2025-10-13
仓库体积165 KB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数3

项目介绍

ringattention 是一个专注于大上下文场景的注意力机制优化项目,旨在解决长序列处理中计算和内存开销过大的问题。它通过环形(ring)分布策略,将注意力计算分散到多个设备或计算单元上,实现高效的并行处理,从而支持超长上下文的模型训练和推理。项目提供简洁的 Python 接口,易于集成到现有深度学习框架中。核心能力包括:动态负载均衡、显存优化、以及针对长序列的线性复杂度近似。它特别适合需要处理数万甚至数十万 token 的 NLP 任务,如文档级理解、长对话生成等。目前项目处于早期阶段,但设计思路清晰,为大规模语言模型的长上下文扩展提供了新方案。

Star 增长趋势

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

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

使用教程

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

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

环境要求

  • 多卡 GPU
  • torch 2.x
  • 高速互联(NVLink/IB)

安装与启动步骤

  1. 1装包

    环形注意力的实现,用于近无限上下文。

    pip install ringattention
  2. 2确认依赖

    需要支持分布式通信的 torch。

    python -c "import torch; print(torch.__version__)"
  3. 3跑单机多卡

    先用 2 卡验证通信是否正确。

    torchrun --nproc_per_node=2 example.py
  4. 4扩到多机

    改 world size 与 master 地址。

    torchrun --nnodes=2 --nproc_per_node=8 --master_addr=<ip> example.py

如何确认成功

序列长度超出单卡上限时仍能前向,且结果与分块计算一致。

注意事项

  • 它的核心是把长序列切成块,在设备间轮转 K/V。
  • 通信带宽是瓶颈,以太网多机基本没收益。
  • 数值正确性建议和短序列实现交叉验证。

核心亮点

  • 采用环形分布策略,有效降低长序列注意力计算的内存峰值
  • 支持动态负载均衡,多设备利用率高,扩展性强
  • 接口简洁,易于集成到 PyTorch 等主流框架

不足之处

  • 早期项目,文档和社区生态尚待完善
  • 对非标准注意力变体的兼容性可能有限

适用场景

  • 训练/推理超长文档(如书籍、法律文书)的 LLM
  • 长对话或多轮交互场景的模型优化
  • 在有限显存下处理超长序列的科研实验

替代项目

FlashAttention、Longformer、BigBird

上一篇:MambaInLlama

下一篇:llm4regression

同类项目推荐

FATE-LLM 开源

数据不出域,多方联合微调大模型

Federated Learning for LLMs.

★ 273 2026-09-16
Prism 开源

动态稀疏注意力,让2K音视频生成模型原生训练更省算力

We propose Prism, a dynamic sparse attention framework for natively training joint v···

★ 1514 2026-10-26
ComfyUI-TrainTools-MZ 开源

在 ComfyUI 里拖拽节点,轻松训练自己的 LoRA 模型

在ComfyUI中进行lora微调的节点,依赖于kohya-ss/sd-scripts等训练工具(Nodes for fine-tun···

★ 66 2026-08-09
Unified-MoE-Compression 开源

给 MoE 模型瘦身,压缩后推理更快更省内存

The official implementation of the paper "Towards Efficient Mixture of Experts: A Ho···

★ 93 2026-08-09
quaterion 开源

几分钟搭好相似度模型训练,向量检索效果快速提升

Blazing fast framework for fine-tuning similarity learning models

★ 665 2026-09-16
merge-models 开源

按比例融合两个扩散模型,快速生成新风格模型

Merges two latent diffusion models at a user-defined ratio

★ 262 2026-08-09
prismaquant 开源

按层敏感度自动分配量化精度,省显存不掉点

Mixed-precision quantization for LLMs. Every layer refracts into a different format ···

★ 105 2026-10-31
spiral 开源

让AI在对抗博弈中练出深度推理

SPIRAL: Self-Play on Zero-Sum Games Incentivizes Reasoning via Multi-Agent Multi-Tur···

★ 211 2026-08-09