ColossalAI

hpcaitechApache-2.0活跃维护

一套面向大模型训练的分布式并行框架,把数据、模型、流水线并行和异构训练整合成统一接口,让训练和推理更省显存、更快。

Making large AI models cheaper, faster and more accessible

v0.5.0发布于 2025-06-04 06:00 UTC41,431star +3 / 7 天4,483fork同步于 2026-11-10 05:19 UTC

怎么上手

由 README 提炼,执行前请确认
pip install colossalai
硬件要求按 README 说明

需 Linux 系统与 NVIDIA GPU,Compute Capability >= 7.0(V100/RTX20 及以上),CUDA >= 11.0;README 未给出具体显存要求,仅给出 8 卡/16 卡跑 7B/70B 的基准数据。

支持 Apple Silicon需要 CUDA多卡 / 张量并行有 Docker 镜像
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

面向大模型训练的分布式并行框架,让大模型训练更便宜更快更易用

一套面向大模型训练的分布式并行框架,把数据、模型、流水线并行和异构训练整合成统一接口,让训练和推理更省显存、更快。

核心能力

  • 支持 ZeRO1/2/3、张量并行、流水并行组合
  • 提供 FP8 混合精度训练,一行代码降低训练成本
  • 安装时默认不编译 CUDA 内核,运行时按需构建
  • 提供 Docker 镜像与 nightly 版本便于快速试用

容易踩的坑

默认不编译 PyTorch 扩展,CUDA 内核在运行时才构建;使用 fused optimizer 必须用 BUILD_EXT=1 安装;仅支持 Linux,PyTorch 需 2.2 以上且低于 2.14、Python 需 3.10 到 3.12。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.5.0
  1. v0.5.0Version v0.5.0 Release Today!最新正式版2025-06-04 · 2025-06-04 06:00 UTC

    What's Changed

    Full Changelog: https://github.com/hpcaitech/ColossalAI/compare/v0.4.9...v0.5.0

  2. v0.4.9Version v0.4.9 Release Today!2025-03-04 · 2025-03-04 01:51 UTC
    查看更新说明

    What's Changed

    Release

    Hotfix

    Misc

    Chat

    • Merge pull request #6208 from hpcaitech/grpo_dev by YeAnbang

    Pre-commit.ci

    Full Changelog: https://github.com/hpcaitech/ColossalAI/compare/v0.4.9...v0.4.8

  3. v0.4.8Version v0.4.8 Release Today!2025-02-20 · 2025-02-20 03:37 UTC
    查看更新说明

    What's Changed

    Release

    Doc

    Application

    • [application] add lora sft example data (#6198) by Hongxin Liu
    • [application] Update README (#6196) by Tong Li
    • [application] add lora sft example (#6192) by Hongxin Liu

    Pre-commit.ci

    • Add GRPO and Support RLVR for PPO (#6186) by YeAnbang

    Checkpointio

    • [checkpointio] fix for async io (#6189) by flybird11111
    • [checkpointio] fix checkpoint for 3d (#6187) by flybird11111
    • [checkpointio] gather tensor before unpad it if the tensor is both padded and distributed (#6168) by Lemon Qin
    • [checkpointio] support load-pin overlap (#6177) by Hongxin Liu

    Hotfix

    • [hotfix] fix zero optim save (#6191) by Hongxin Liu
    • [hotfix] fix hybrid checkpointio for sp+dp (#6184) by flybird11111

    Shardformer

    • [shardformer] support pipeline for deepseek v3 and optimize lora save (#6188) by Hongxin Liu
    • [shardformer] support ep for deepseek v3 (#6185) by Hongxin Liu

    Ci

    • [CI] Cleanup Dist Optim tests with shared helper funcs (#6125) by Wenxuan Tan

    Issue template

    • [Issue template] Add checkbox asking for details to reproduce error (#6104) by Wenxuan Tan

    Inference

    Full Changelog: https://github.com/hpcaitech/ColossalAI/compare/v0.4.8...v0.4.7

  4. v0.4.7Version v0.4.7 Release Today!2025-01-03 · 2025-01-03 03:53 UTC
    查看更新说明

    What's Changed

    Release

    Pre-commit.ci

    Sharderformer

    • [Sharderformer] Support zbv in Sharderformer Policy (#6150) by duanjunwen

    Checkpointio

    • [checkpointio] support non blocking pin load (#6172) by Hongxin Liu
    • [checkpointio]support asyncio for 3d (#6152) by flybird11111
    • [checkpointio] fix async io (#6155) by flybird11111
    • [checkpointio] support debug log (#6153) by Hongxin Liu
    • [checkpointio] fix zero optimizer async save memory (#6151) by Hongxin Liu
    • Merge pull request #6149 from ver217/hotfix/ckpt by Wang Binluo
    • [checkpointio] disable buffering by ver217
    • [checkpointio] fix pinned state dict by ver217
    • [checkpointio] fix size compute by ver217
    • [checkpointio] fix performance issue (#6139) by Hongxin Liu
    • [checkpointio] support async model save (#6131) by Hongxin Liu

    News

    • [news] release colossalai for sora (#6166) by binmakeswell

    Hotfix

    • [hotfix] improve compatibility (#6165) by Hongxin Liu
    • [Hotfix] hotfix normalization (#6163) by duanjunwen
    • [hotfix] fix zero comm buffer init (#6154) by Hongxin Liu
    • [hotfix] fix flash attn window_size err (#6132) by duanjunwen

    Doc

    • [doc] add bonus event (#6164) by binmakeswell
    • [doc] update cloud link (#6148) by Sze-qq
    • [doc] add hpc cloud intro (#6147) by Sze-qq

    Device

    Fix

    • [fix] fix bug caused by perf version (#6156) by duanjunwen
    • [fix] multi-node backward slowdown (#6134) by Hanks

    Optim

    Zerobubble

    Async io

    Ckpt

    Cli

    • [cli] support run as module option (#6135) by Hongxin Liu

    Zero

    Coati

    • [Coati] Refine prompt for better inference (#6117) by Tong Li

    Plugin

    • [plugin] support get_grad_norm (#6115) by Hongxin Liu

    Full Changelog: https://github.com/hpcaitech/ColossalAI/compare/v0.4.7...v0.4.6

  5. v0.4.6Version v0.4.6 Release Today!2024-11-04 · 2024-11-04 09:28 UTC
    查看更新说明

    What's Changed

    Release

    Pre-commit.ci

    Checkpointio

    • [checkpointio] fix hybrid plugin model save (#6106) by Hongxin Liu

    Mcts

    • [MCTS] Add self-refined MCTS (#6098) by Tong Li

    Doc

    Extension

    • [extension] hotfix compile check (#6099) by Hongxin Liu

    Hotfix

    • Merge pull request #6096 from BurkeHulk/hotfix/lora_ckpt by Hanks

    Full Changelog: https://github.com/hpcaitech/ColossalAI/compare/v0.4.6...v0.4.5

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Colossal-AI

    logo

    Colossal-AI: Making large AI models cheaper, faster, and more accessible

    GitHub Repo stars Build Documentation CodeFactor HuggingFace badge slack badge WeChat badge

    | English | 中文 |

    Instantly Run Colossal-AI on Enterprise-Grade GPUs

    Skip the setup. Access a powerful, pre-configured Colossal-AI environment on HPC-AI Cloud.

    Train your models and scale your AI workload in one click!

    • NVIDIA Blackwell B200s: Experience the next generation of AI performance (See Benchmarks). Now available on cloud from $2.47/hr.
    • Cost-Effective H200 Cluster: Get premier performance with on-demand rental from just $1.99/hr.

    Get Started Now & Claim Your Free Credits →

    Instant Access Top Open Models at Half the Cost

    Skip the hassle. Access powerful, long-context LLMs seamlessly through HPC-AI Model APIs.

    Build your AI agents, chatbots, and RAG applications with HPC-AI Model APIs!

    • Latest & Greatest Models: Experience state-of-the-art performance with Kimi 2.5, MiniMax 2.5, and GLM 5.1. Perfect for massive 2M+ context windows and complex coding tasks.

    • Unbeatable Pricing: Stop overpaying for API endpoints. Get premier inference speed at up to 50% cheaper than OpenRouter.

    Get Started Now & Claim Your $4 Free Credits →

    Colossal-AI Benchmark

    To see how these performance gains translate to real-world applications, we conducted a large language model training benchmark using Colossal-AI on Llama-like models. The tests were run on both 8-card and 16-card configurations for 7B and 70B models, respectively.

    GPUGPUsModel SizeParallelismBatch Size per DPSeqlenThroughputTFLOPS/GPUPeak Mem(MiB)
    H20087Bzero2(dp8)36409617.13 samp/s534.18119040.02
    H2001670Bzero24840963.27 samp/s469.1150032.23
    B20087Bzero1(dp2)+tp2+pp4128409625.83 samp/s805.69100119.77
    H2001670Bzero1(dp2)+tp2+pp412840965.66 samp/s811.79100072.02

    The results from the Colossal-AI benchmark provide the most practical insight. For the 7B model on 8 cards, the B200 achieved a 50% higher throughput and a significant increase in TFLOPS per GPU. For the 70B model on 16 cards, the B200 again demonstrated a clear advantage, with over 70% higher throughput and TFLOPS per GPU. These numbers show that the B200's performance gains translate directly to faster training times for large-scale models.

    Latest News

    Table of Contents

    Why Colossal-AI

    Prof. James Demmel (UC Berkeley): Colossal-AI makes training AI models efficient, easy, and scalable.

    Features

    Colossal-AI provides a collection of parallel components for you. We aim to support you to write your distributed deep learning models just like how you write your model on your laptop. We provide user-friendly tools to kickstart distributed training and inference in a few lines.

    Colossal-AI in the Real World

    Open-Sora

    Open-Sora:Revealing Complete Model Parameters, Training Details, and Everything for Sora-like Video Generation Models [code] [blog] [Model weights] [Demo] [GPU Cloud Playground] [OpenSora Image]

    Colossal-LLaMA-2

    [GPU Cloud Playground] [LLaMA3 Image]

    ModelBackboneTokens ConsumedMMLU (5-shot)CMMLU (5-shot)AGIEval (5-shot)GAOKAO (0-shot)CEval (5-shot)
    Baichuan-7B-1.2T42.32 (42.30)44.53 (44.02)38.7236.7442.80
    Baichuan-13B-Base-1.4T50.51 (51.60)55.73 (55.30)47.2051.4153.60
    Baichuan2-7B-Base-2.6T46.97 (54.16)57.67 (57.07)45.7652.6054.00
    Baichuan2-13B-Base-2.6T54.84 (59.17)62.62 (61.97)52.0858.2558.10
    ChatGLM-6B-1.0T39.67 (40.63)41.17 (-)40.1036.5338.90
    ChatGLM2-6B-1.4T44.74 (45.46)49.40 (-)46.3645.4951.70
    InternLM-7B-1.6T46.70 (51.00)52.00 (-)44.7761.6452.80
    Qwen-7B-2.2T54.29 (56.70)56.03 (58.80)52.4756.4259.60
    Llama-2-7B-2.0T44.47 (45.30)32.97 (-)32.6025.46-
    Linly-AI/Chinese-LLaMA-2-7B-hfLlama-2-7B1.0T37.4329.9232.0027.57-
    wenge-research/yayi-7b-llama2Llama-2-7B-38.5631.5230.9925.95-
    ziqingyang/chinese-llama-2-7bLlama-2-7B-33.8634.6934.5225.1834.2
    TigerResearch/tigerbot-7b-baseLlama-2-7B0.3T43.7342.0437.6430.61-
    LinkSoul/Chinese-Llama-2-7bLlama-2-7B-48.4138.3138.4527.72-
    FlagAlpha/Atom-7BLlama-2-7B0.1T49.9641.1039.8333.00-
    IDEA-CCNL/Ziya-LLaMA-13B-v1.1Llama-13B0.11T50.2540.9940.0430.54-
    Colossal-LLaMA-2-7b-baseLlama-2-7B0.0085T53.0649.8951.4858.8250.2
    Colossal-LLaMA-2-13b-baseLlama-2-13B0.025T56.4261.8054.6969.5360.3

    ColossalChat

    ColossalChat: An open-source solution for cloning ChatGPT with a complete RLHF pipeline. [code] [blog] [demo] [tutorial]

    • Up to 10 times faster for RLHF PPO Stage3 Training
    • Up to 7.73 times faster for single server training and 1.42 times faster for single-GPU inference
    • Up to 10.3x growth in model capacity on one GPU
    • A mini demo training process requires only 1.62GB of GPU memory (any consumer-grade GPU)
    • Increase the capacity of the fine-tuning model by up to 3.7 times on a single GPU
    • Keep at a sufficiently high running speed

    AIGC

    Acceleration of AIGC (AI-Generated Content) models such as Stable Diffusion v1 and Stable Diffusion v2.

    • Training: Reduce Stable Diffusion memory consumption by up to 5.6x and hardware cost by up to 46x (from A100 to RTX3060).
    • Inference: Reduce inference GPU memory consumption by 2.5x.

    Biomedicine

    Acceleration of AlphaFold Protein Structure

    • FastFold: Accelerating training and inference on GPU Clusters, faster data processing, inference sequence containing more than 10000 residues.
    • xTrimoMultimer: accelerating structure prediction of protein monomers and multimer by 11x.

    Parallel Training Demo

    LLaMA3

    LLaMA2

    • 70 billion parameter LLaMA2 model training accelerated by 195% [code] [blog]

    LLaMA1

    • 65-billion-parameter large model pretraining accelerated by 38% [code] [blog]

    MoE

    • Enhanced MoE parallelism, Open-source MoE model training can be 9 times more efficient [code] [blog]

    GPT-3

    • Save 50% GPU resources and 10.7% acceleration

    GPT-2

    • 11x lower GPU memory consumption, and superlinear scaling efficiency with Tensor Parallelism
    • 24x larger model size on the same hardware
    • over 3x acceleration

    BERT

    • 2x faster training, or 50% longer sequence length

    PaLM

    OPT

    • Open Pretrained Transformer (OPT), a 175-Billion parameter AI language model released by Meta, which stimulates AI programmers to perform various downstream tasks and application deployments because of public pre-trained model weights.
    • 45% speedup fine-tuning OPT at low cost in lines. [Example] [Online Serving]

    Please visit our documentation and examples for more details.

    ViT

    • 14x larger batch size, and 5x faster training for Tensor Parallelism = 64

    Recommendation System Models

    • Cached Embedding, utilize software cache to train larger embedding tables with a smaller GPU memory budget.

    Single GPU Training Demo

    GPT-2

    • 20x larger model size on the same hardware
    • 120x larger model size on the same hardware (RTX 3080)

    PaLM

    • 34x larger model size on the same hardware

    Inference

    Colossal-Inference

    Grok-1

    • 314 Billion Parameter Grok-1 Inference Accelerated by 3.8x, an easy-to-use Python + PyTorch + HuggingFace version for Inference.

    [code] [blog] [HuggingFace Grok-1 PyTorch model weights] [ModelScope Grok-1 PyTorch model weights]

    SwiftInfer

    • SwiftInfer: Inference performance improved by 46%, open source solution breaks the length limit of LLM for multi-round conversations

    Installation

    Requirements:

    If you encounter any problem with installation, you may want to raise an issue in this repository.

    Install from PyPI

    You can easily install Colossal-AI with the following command. By default, we do not build PyTorch extensions during installation.

    pip install colossalai
    

    Note: only Linux is supported for now.

    However, if you want to build the PyTorch extensions during installation, you can set BUILD_EXT=1.

    BUILD_EXT=1 pip install --no-binary=colossalai --no-build-isolation colossalai
    

    Otherwise, CUDA kernels will be built during runtime when you actually need them.

    We also keep releasing the nightly version to PyPI every week. This allows you to access the unreleased features and bug fixes in the main branch. Installation can be made via

    pip install colossalai-nightly
    

    Download From Source

    The version of Colossal-AI will be in line with the main branch of the repository. Feel free to raise an issue if you encounter any problems. :)

    git clone https://github.com/hpcaitech/ColossalAI.git
    cd ColossalAI
    
    # install colossalai
    pip install .
    

    By default, we do not compile CUDA/C++ kernels. ColossalAI will build them during runtime. If you want to install and enable CUDA kernel fusion (compulsory installation when using fused optimizer):

    BUILD_EXT=1 pip install --no-build-isolation .
    

    For Users with CUDA 10.2, you can still build ColossalAI from source. However, you need to manually download the cub library and copy it to the corresponding directory.

    # clone the repository
    git clone https://github.com/hpcaitech/ColossalAI.git
    cd ColossalAI
    
    # download the cub library
    wget https://github.com/NVIDIA/cub/archive/refs/tags/1.8.0.zip
    unzip 1.8.0.zip
    cp -r cub-1.8.0/cub/ colossalai/kernel/cuda_native/csrc/kernels/include/
    
    # install
    BUILD_EXT=1 pip install --no-build-isolation .
    

    Use Docker

    Pull from DockerHub

    You can directly pull the docker image from our DockerHub page. The image is automatically uploaded upon release.

    Build On Your Own

    Run the following command to build a docker image from Dockerfile provided.

    Building Colossal-AI from scratch requires GPU support, you need to use Nvidia Docker Runtime as the default when doing docker build. More details can be found here. We recommend you install Colossal-AI from our project page directly.

    cd ColossalAI
    docker build -t colossalai ./docker
    

    Run the following command to start the docker container in interactive mode.

    docker run -ti --gpus all --rm --ipc=host colossalai bash
    

    Community

    Join the Colossal-AI community on Forum, Slack, and WeChat(微信) to share your suggestions, feedback, and questions with our engineering team.

    Contributing

    Referring to the successful attempts of BLOOM and Stable Diffusion, any and all developers and partners with computing powers, datasets, models are welcome to join and build the Colossal-AI community, making efforts towards the era of big AI models!

    You may contact us or participate in the following ways:

    1. Leaving a Star ⭐ to show your like and support. Thanks!
    2. Posting an issue, or submitting a PR on GitHub follow the guideline in Contributing
    3. Send your official proposal to email [email protected]

    Thanks so much to all of our amazing contributors!

    CI/CD

    We leverage the power of GitHub Actions to automate our development, release and deployment workflows. Please check out this documentation on how the automated workflows are operated.

    Cite Us

    This project is inspired by some related projects (some by our team and some by other organizations). We would like to credit these amazing projects as listed in the Reference List.

    To cite this project, you can use the following BibTeX citation.

    @inproceedings{10.1145/3605573.3605613,
    author = {Li, Shenggui and Liu, Hongxin and Bian, Zhengda and Fang, Jiarui and Huang, Haichen and Liu, Yuliang and Wang, Boxiang and You, Yang},
    title = {Colossal-AI: A Unified Deep Learning System For Large-Scale Parallel Training},
    year = {2023},
    isbn = {9798400708435},
    publisher = {Association for Computing Machinery},
    address = {New York, NY, USA},
    url = {https://doi.org/10.1145/3605573.3605613},
    doi = {10.1145/3605573.3605613},
    abstract = {The success of Transformer models has pushed the deep learning model scale to billions of parameters, but the memory limitation of a single GPU has led to an urgent need for training on multi-GPU clusters. However, the best practice for choosing the optimal parallel strategy is still lacking, as it requires domain expertise in both deep learning and parallel computing. The Colossal-AI system addressed the above challenge by introducing a unified interface to scale your sequential code of model training to distributed environments. It supports parallel training methods such as data, pipeline, tensor, and sequence parallelism and is integrated with heterogeneous training and zero redundancy optimizer. Compared to the baseline system, Colossal-AI can achieve up to 2.76 times training speedup on large-scale models.},
    booktitle = {Proceedings of the 52nd International Conference on Parallel Processing},
    pages = {766–775},
    numpages = {10},
    keywords = {datasets, gaze detection, text tagging, neural networks},
    location = {Salt Lake City, UT, USA},
    series = {ICPP '23}
    }
    

    Colossal-AI has been accepted as official tutorial by top conferences NeurIPS, SC, AAAI, PPoPP, CVPR, ISC, NVIDIA GTC ,etc.