项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-25 · 当前星标 ★ 8382
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- Linux 环境(README 示例为 Ubuntu 24.04),具备 sudo 权限
- Rust 工具链(通过 rustup 安装)
- Python 3 与 uv 包管理器
- 可用的 Kubernetes 集群及 kubectl,用于应用部署清单
- 推理后端所需 GPU 环境(vLLM、SGLang、TensorRT-LLM 等)
安装与启动步骤
-
1安装系统依赖
编译 Dynamo 需要 C/C++ 构建工具、hwloc、udev、protobuf 与 clang 等开发库,按 README 的 Ubuntu 24.04 命令一次性安装。
sudo apt install -y build-essential libhwloc-dev libudev-dev pkg-config libclang-dev protobuf-compiler python3-dev cmake -
2安装 Rust 工具链
用 rustup 安装 Rust 并加载环境变量,之后 cargo 命令才可用;如已安装可跳过。
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh && source $HOME/.cargo/env -
3安装 uv 包管理器
README 的 PyPI 安装路线要求先装 uv,脚本安装后需重开终端或手动加载 PATH。
curl -LsSf https://astral.sh/uv/install.sh | sh -
4克隆项目仓库
克隆后可获得 recipes(模型配方)、examples(示例)与 docs 文档目录,便于按模型选择部署方案。
git clone https://github.com/ai-dynamo/dynamo.git cd dynamo -
5从 PyPI 安装
README 说明可通过 PyPI 安装 dynamo,但未给出具体包名与安装参数,请以官方文档 docs.nvidia.com/dynamo 给出的命令为准。
-
6编写部署清单
零配置部署只需声明模型、推理后端和 SLA 目标,Dynamo 自动完成资源编排与参数选择。
-
7应用清单到集群
确保 kubectl 已指向可用的 Kubernetes 集群,再应用上述清单;autoApply 为 true 时资源会被自动应用。
kubectl apply -f dynamo-deployment.yaml
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
metadata.name | 是 | 部署请求资源名称,自定义即可 | my-model |
spec.model | 是 | 要部署的模型 ID,可换成自己的目标模型 | Qwen/Qwen3-0.6B |
spec.backend | 是 | 推理后端类型,README 支持 vllm、sglang、tensorrt-llm | vllm |
spec.sla.ttft | 否 | 首 token 延迟目标,单位毫秒,用于自动选型与调度 | 200.0 |
spec.sla.itl | 否 | token 间延迟目标,单位毫秒 | 20.0 |
spec.autoApply | 否 | 设为 true 时请求提交后自动应用部署 | true |
如何确认成功
应用后用 kubectl get dynamographdeploymentrequest 查看请求状态;autoApply 为 true 时应自动生成并启动部署资源。
常见问题
Q:没有自建 Kubernetes 集群怎么部署?
A:README 提供了 AWS EKS、Google GKE、Azure AKS 的托管集群安装指南,以及 NGC 上的预构建容器,可按对应文档在云上集群部署。
Q:编译失败提示找不到 libclang 或 protobuf?
A:缺少构建依赖,重新执行 README 中的 apt 安装命令,确保 libclang-dev、protobuf-compiler、cmake、pkg-config 均已装好。
Q:支持哪些推理后端?
A:README 提到 vLLM、SGLang、TensorRT-LLM,清单里通过 spec.backend 指定,如 vllm。
Q:有没有现成模型的部署配方?
A:有,recipes 目录提供多个预制配方,如 Qwen3-32B-FP8(TensorRT-LLM 聚合模式)、DeepSeek-R1(SGLang 分离模式)、Kimi-K3(vLLM 聚合模式)。
注意事项
- 文中命令均来自 README 节选;PyPI 安装的具体包名与参数请以官方文档为准,不要臆测参数。
- Rust 项目首次编译耗时较长,建议准备足够的 CPU 与磁盘空间。
- 部署前确认集群已有可用 GPU 节点与对应驱动环境,否则推理后端无法启动。
- 模型配方与云厂商指南分别位于仓库 recipes/ 目录和 docs 目录下的 kubernetes 文档中。
核心亮点
- 解耦式 prefill/decode 服务,可分别扩缩容,提升资源利用率
- 统一编排 vLLM、SGLang、TensorRT-LLM 等多种后端,兼容现有生态
- Rust 实现的路由与调度层,面向 Kubernetes 数据中心规模部署
不足之处
- 依赖 Kubernetes 与多组件,部署和运维门槛较高
- 项目仍在快速演进,接口与配置可能变动,文档/社区待观察
适用场景
- 多模型、高并发的在线推理服务平台
- Kubernetes 集群上的 GPU 资源池化与统一调度
- 需要 prefill/decode 分离以优化长上下文推理成本的场景
替代项目
vLLM、SGLang、KServe
同类项目推荐
CPA-Manager-Plus
开源
自托管AI网关监控面板,管好每次API调用和成本
A self-hosted CPA / CLIProxyAPI management panel and AI gateway observability dashbo···
nim-anywhere
开源
一键部署 NVIDIA NIM,让生成式 AI 应用秒级落地
Accelerate your Gen AI with NVIDIA NIM and NVIDIA AI Workbench
mlops-templates
开源
把机器学习模型快速、标准化地部署到 Azure 生产环境
Azure MLOps (v2) solution accelerators. Enterprise ready templates to deploy your ma···
k8ssandra-operator
开源
在 K8s 上像管理应用一样管理 Cassandra 集群,自动部署与运维
The Kubernetes operator for K8ssandra
dante-cloud
开源
一套代码灵活切换微服务与单体,安全合规的云原生基座。
Dante Cloud 是支持阻塞式与响应式服务并行的微服务云原生基座和面向AI Agent开发的智能基···
Containarium
开源
给 AI 代理套上安全隔离壳,放心执行任意代码
Open-source agent runtime — SSH-native isolation, eBPF egress policy, Kubernetes + ···
voidllm
开源
自托管 AI 网关,统一管理多模型 API,保护提示词隐私。
Privacy-first LLM proxy and AI gateway - load balancing, multi-provider routing, API···
zon-TS
开源
用 ZON 格式替代 JSON,提示词 token 成本直降 35-70%
ZON → 35-70% cheaper LLM prompts than JSON/TOON. Zero overhead.
opencode-llm-proxy
开源
本地一个代理,统一接入 OpenAI、Anthropic、Gemini 等大模型
Local OpenCode-backed LLM gateway for OpenAI, Anthropic, Gemini, and Responses API-c···
