AngelSlim

一键压缩大模型,部署更快更省资源

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 197 🐛 待处理 69 👀 关注 19
GitHub ↗
GitHub 星标 ★ 1787
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源模型压缩工具包,MIT许可证,完全免费,可自行部署使用。

项目预览

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

项目数据

分类开源模型
开发团队Tencent
定价模式🏷️完全免费
价格说明开源模型压缩工具包,MIT许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议NOASSERTION
主要语言Python
技术栈/模型audio,deepseek,dflash,diffusion,eagle,fp4,hunyuan,llm,llm-compression,quantization,qwen,speculative-decoding,vlm
GitHub 星标★ 1787
上线时间2025-07-04 00:00:00
代码更新2026-10-31
仓库体积89.8 MB
本站数据更新2026-11-09
维护状态较活跃
收录时间2026-08-09
浏览次数8

项目介绍

AngelSlim 是一个面向大语言模型的开源压缩工具包,旨在让模型压缩更易用、更全面、更高效。它解决了模型部署中体积大、推理慢、成本高的问题,提供从剪枝、量化到蒸馏的一站式压缩方案。核心能力包括:支持多种主流模型架构(如LLaMA、Qwen等),提供统一的压缩接口和自动化配置,能显著减少模型参数量和显存占用,同时尽量保持模型性能。工具包设计上强调用户友好,通过简单的API调用即可完成复杂的压缩流程,并内置了压缩后模型的效果评估功能,帮助用户在压缩率与精度损失之间找到平衡。

Star 增长趋势

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

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

使用教程

难度:进阶 约 30 分钟 部署方式:库/依赖 8 步

环境要求

  • Python 环境(可执行 pip 命令)
  • 安装 vLLM 时建议 vllm>=0.8.5.post1,MOE INT8 量化模型需 vllm>=0.9.0
  • 安装 SGLang 时建议 sglang>=0.4.6.post1
  • 单机快速开始示例需要 4 张 GPU(2 张推理 + 2 张训练)
  • 克隆源码需支持 git submodule 的 git 环境

安装与启动步骤

  1. 1安装 AngelSlim

    官方推荐用 pip 直接安装最新稳定版 AngelSlim,最省事,装完即可调用压缩接口。

    pip install angelslim
  2. 2源码方式安装

    想改代码或跟踪最新功能时,用递归克隆仓库并以可编辑/源码方式安装,注意必须带 --recursive。

    git clone --recursive https://github.com/Tencent/AngelSlim.git
    cd AngelSlim && python setup.py install
  3. 3初始化子模块

    AngelSpec 以 git submodule 形式放在 third_party/AngelSpec/,已克隆的仓库要手动初始化拉取。

    git submodule update --init --recursive
  4. 4装 AngelSpec 与 vLLM

    进入子模块目录安装 AngelSpec 及其 vLLM 后端,这是跑投机解码训练与推理的前置依赖。

    cd third_party/AngelSpec
    pip install -e ".[vllm]"
  5. 5装 mooncake 传输引擎

    隐藏状态传输组件不在 extras 里,必须单独安装,否则分布式训练链路会缺依赖。

    pip install mooncake-transfer-engine
  6. 6运行单机快速开始

    仓库自带 qwen3-8b 单机示例脚本,默认用 4 张卡(2 推理 + 2 训练),先确保卡空闲。

    ./examples/qwen3-8b-single-node/run.sh
  7. 7部署 vLLM 服务

    把 MODEL_PATH 换成你的量化模型路径,用脚本拉起 OpenAI 兼容接口;-d 选卡、-t 张量并行、-p 流水并行、-g 显存利用率。

    bash scripts/deploy/run_vllm.sh --model-path /your/model/path --port 8080 -d 0,1,2,3 -t 4 -p 1 -g 0.8 --max-model-len 4096
  8. 8部署 SGLang 服务

    不想用 vLLM 时可换 SGLang 脚本部署同样的 OpenAI 兼容服务,参数含义与 vLLM 脚本基本一致。

    bash scripts/deploy/run_sglang.sh --model-path /your/model/path --port 8080 -d 0,1,2,3 -t 4 -g 0.8

关键配置

配置项必填说明示例
--model-path是指定已量化好的模型目录路径/your/model/path
--port否API 服务监听端口8080
-d否可见的 GPU 设备编号列表0,1,2,3
-t否张量并行大小(tensor parallel size)4
-p否流水并行大小,vLLM 脚本参数1
-g否GPU 显存利用率,显存不足可调小0.8

如何确认成功

访问 http://localhost:8080 的 OpenAI 兼容接口能正常返回;单机示例脚本无报错跑通即成功。

常见问题

Q:克隆后运行提示缺少 AngelSpec/子模块为空怎么办?

A:说明克隆时没带子模块。重新用 git clone --recursive 克隆,或在已有仓库里执行 git submodule update --init --recursive 拉取。

Q:MOE INT8 量化模型部署失败怎么排查?

A:vLLM 版本过低。普通模型用 vllm>=0.8.5.post1,MOE INT8 量化模型必须升级到 vllm>=0.9.0。

Q:单机快速开始脚本跑不起来?

A:该示例默认需要 4 张 GPU(2 张推理 + 2 张训练),请确认显卡数量与空闲状态,或改用其他部署方式。

Q:pip 安装后还需要装 vLLM 后端吗?

A:需要。pip install angelslim 只装 AngelSlim 本体,跑 AngelSpec 训练/推理还要进 third_party/AngelSpec 执行 pip install -e ".[vllm]"。

注意事项

  • AngelSlim 集成 AngelSpec 作为 git submodule,克隆时务必加 --recursive,否则子模块目录为空。
  • mooncake-transfer-engine 不在 extras 依赖中,必须单独 pip install。
  • vLLM 脚本与 SGLang 脚本参数不完全一致,SGLang 脚本没有 -p 参数。
  • 更详细的安装与平台适配说明以官方 Installation 文档为准。

核心亮点

  • 支持剪枝、量化、蒸馏等多种压缩方法,覆盖全面
  • API设计简洁,几行代码即可完成模型压缩流程
  • 自动评估压缩后模型效果,方便权衡性能与体积

不足之处

  • 文档/社区待观察
  • 对超大模型(千亿参数)的压缩效率尚未验证

适用场景

  • 将大模型部署到边缘设备或移动端
  • 降低云端推理服务的GPU显存和成本
  • 快速生成可用于测试的轻量级模型副本

替代项目

llm-compressor、SparseGPT、GPTQ

上一篇:RLHF-Reward-Modeling

下一篇:ReCall

同类项目推荐

Matlab-GAN 开源

用 MATLAB 跑通多种 GAN,从入门到 CycleGAN 一步到位

MATLAB implementations of Generative Adversarial Networks -- from GAN to Pixel2Pixel···

★ 209 2026-08-09
nanochat-mlx 开源

在 Mac 上训练你自己的 ChatGPT,无需云 GPU

Train your own ChatGPT on Apple Silicon — MLX port of nanochat

★ 78 2026-08-09
miles 开源

企业级 RL 后训练框架,让大模型和多模态模型快速做强化微调

Miles is an enterprise-facing reinforcement learning framework for LLM and VLM post-···

★ 3280 2026-10-07
chatgpt-finetune-ui 开源

拖拽上传数据,点点鼠标就能微调 ChatGPT 模型

Simple python WebUI for fine-tuning ChatGPT (gpt-3.5-turbo)

★ 173 2026-08-09
GEM 开源

微调时保住模型创造力,让生成不再千篇一律

Code for Paper (Preserving Diversity in Supervised Fine-tuning of Large Language Mod···

★ 62 2026-08-09
comfyUI-Realtime-Lora 开源

在 ComfyUI 里直接训练、编辑和保存 LoRA,无需切换工具

Train and block edit and save LoRAs directly inside ComfyUI for Z-image, Flux Klein···

★ 576 2026-08-09
LLaSA_training 开源

用LLM算力换自然语音,训练推理双扩展

LLaSA: Scaling Train-time and Inference-time Compute for LLaMA-based Speech Synthesi···

★ 658 2026-08-09