项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3060
技术标签
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- 华为昇腾(Ascend)NPU 硬件环境
- 已安装与所选版本匹配的昇腾 CANN 驱动与工具包
- 可访问官方文档站点(docs.vllm.ai/projects/ascend)以获取版本对应的安装命令
- Python 运行环境(vLLM 及其依赖,具体版本要求见官方 Installation 文档)
安装与启动步骤
-
1确认版本对应关系
先看 Support Matrix,确认自家昇腾硬件、CANN 版本与插件版本的对应关系,再决定装哪个版本。
-
2选择发行版本
v0.23.0 为最新稳定版,v0.26.0rc1 为候选版本;生产环境建议使用稳定版 v0.23.0。
-
3按官方文档安装
打开所选版本对应的 Installation 文档页,按其给出的步骤和命令完成安装,不要混用不同版本的文档。
-
4可选:克隆仓库
如需查看源码、示例或自行构建,可克隆仓库;具体构建参数以官方文档为准。
git clone https://github.com/vllm-project/vllm-ascend.git -
5运行快速开始
按所选版本对应的 QuickStart 文档启动服务并发起推理请求,验证插件在昇腾设备上可用。
如何确认成功
按官方 QuickStart 运行示例推理请求,若能正常返回生成结果,说明 vLLM Ascend 插件已成功运行在昇腾 NPU 上。
常见问题
Q:README 里为什么没有具体的安装命令?
A:本项目把安装细节放在官方文档中,README 只给出获取方式。请按所选版本打开对应版本的 Installation 与 QuickStart 页面,照着执行。
Q:应该安装哪个版本?
A:v0.23.0 是当前最新稳定版本,建议优先使用;v0.26.0rc1 为候选版本,适合尝鲜和验证,不建议直接用于生产。
Q:没有昇腾 NPU 设备能安装吗?
A:本项目是 vLLM 在昇腾硬件上的插件,README 未说明可在无昇腾设备的环境使用,请先准备昇腾 NPU 及匹配的 CANN 环境。
Q:安装或使用中遇到问题去哪里问?
A:可加入 Slack 频道 #SIG-Ascend,或在 vLLM 用户论坛的 vLLM Ascend Support 版块提问,也可参加每周例会。
注意事项
- README 未提供任何具体安装命令、端口或路径,实际安装步骤必须以官方文档对应版本页面为准,不要照抄其他版本的操作。
- 插件版本、vLLM 版本与 CANN 版本需要匹配,安装前务必查看支持矩阵(Support Matrix)。
- 不同发行版本(v0.23.0 与 v0.26.0rc1)对应不同的文档地址,请确保文档版本与实际安装版本一致。
核心亮点
- 直接复用 vLLM 生态,API 兼容,迁移成本低
- 针对昇腾硬件深度优化,发挥 NPU 算力
- 社区活跃,与上游 vLLM 同步更新
不足之处
- 依赖特定昇腾硬件和 CANN 版本,环境配置复杂
- 部分高级特性(如某些量化、投机采样)可能滞后于上游
适用场景
- 在华为昇腾服务器上部署大模型推理服务
- 企业私有化部署,利用现有昇腾算力
- 开发基于昇腾的 LLM 应用,需要 vLLM 兼容接口
替代项目
vllm-cpu、vllm-rocm、TensorRT-LLM
同类项目推荐
kronk
开源
Go 项目一键接入本地大模型、语音和图像生成
Go With Your Own Intelligence! Use Go for hardware accelerated local inference with ···
OpenLLM
开源
开源大模型一键变成标准接口,部署上线像点外卖
Run any open-source LLMs, such as DeepSeek and Llama, as OpenAI compatible API endpo···
cresset
开源
一键从源码构建任意版本 PyTorch 环境
Template repository to build PyTorch projects from source on any version of PyTorch/···
ReadyLLM
开源
图形界面一键部署本地大模型,还能顺手跑图生视频
Deploy, monitor, and tune LLM through a visual interface — plus image / video gener···
Portable-Local-Studio
开源
一个界面跑齐本地画图、聊天、朗读和听写,免安装随身带
Portable local AI studio for Windows, Linux, and macOS. Zero-setup GUI for Image Gen···
dify-google-cloud-terraform
开源
在 Google Cloud 上快速部署生产级 Dify,自动搞定高可用和弹性伸缩。
Terraform configuration for deploying Dify on Google Cloud with scalability, high av···
nano-vectordb
开源
百行代码搞定向量检索,轻松上手随意改
A simple, easy-to-hack Vector Database
sagemaker-genai-hosting-examples
开源
照着 Notebook 跑通大模型托管与推理
MegaParse
开源
解析文档零丢失,直接喂给大模型
File Parser optimised for LLM Ingestion with no loss Parse PDFs, Docx, PPTx in a fo···
