
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1787
使用教程
环境要求
- 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安装 AngelSlim
官方推荐用 pip 直接安装最新稳定版 AngelSlim,最省事,装完即可调用压缩接口。
pip install angelslim -
2源码方式安装
想改代码或跟踪最新功能时,用递归克隆仓库并以可编辑/源码方式安装,注意必须带 --recursive。
git clone --recursive https://github.com/Tencent/AngelSlim.git cd AngelSlim && python setup.py install -
3初始化子模块
AngelSpec 以 git submodule 形式放在 third_party/AngelSpec/,已克隆的仓库要手动初始化拉取。
git submodule update --init --recursive -
4装 AngelSpec 与 vLLM
进入子模块目录安装 AngelSpec 及其 vLLM 后端,这是跑投机解码训练与推理的前置依赖。
cd third_party/AngelSpec pip install -e ".[vllm]" -
5装 mooncake 传输引擎
隐藏状态传输组件不在 extras 里,必须单独安装,否则分布式训练链路会缺依赖。
pip install mooncake-transfer-engine -
6运行单机快速开始
仓库自带 qwen3-8b 单机示例脚本,默认用 4 张卡(2 推理 + 2 训练),先确保卡空闲。
./examples/qwen3-8b-single-node/run.sh -
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部署 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
下一篇:ReCall
同类项目推荐
Matlab-GAN
开源
用 MATLAB 跑通多种 GAN,从入门到 CycleGAN 一步到位
MATLAB implementations of Generative Adversarial Networks -- from GAN to Pixel2Pixel···
nanochat-mlx
开源
在 Mac 上训练你自己的 ChatGPT,无需云 GPU
Train your own ChatGPT on Apple Silicon — MLX port of nanochat
simple-llm-finetuner
开源
拖拽式界面,小白也能微调大模型
Simple UI for LLM Model Finetuning
miles
开源
企业级 RL 后训练框架,让大模型和多模态模型快速做强化微调
Miles is an enterprise-facing reinforcement learning framework for LLM and VLM post-···
chatgpt-finetune-ui
开源
拖拽上传数据,点点鼠标就能微调 ChatGPT 模型
Simple python WebUI for fine-tuning ChatGPT (gpt-3.5-turbo)
GEM
开源
微调时保住模型创造力,让生成不再千篇一律
Code for Paper (Preserving Diversity in Supervised Fine-tuning of Large Language Mod···
comfyUI-Realtime-Lora
开源
在 ComfyUI 里直接训练、编辑和保存 LoRA,无需切换工具
Train and block edit and save LoRAs directly inside ComfyUI for Z-image, Flux Klein···
LLaSA_training
开源
用LLM算力换自然语音,训练推理双扩展
LLaSA: Scaling Train-time and Inference-time Compute for LLaMA-based Speech Synthesi···
Awesome-LLM-On-Policy-Distillati···
开源
一网打尽LLM在线策略蒸馏论文,快速跟上研究前沿
A curated collection of papers and resources on On-Policy Distillation for Large Lan···