What it is
FastDeploy is a Python inference and deployment toolkit for large language models and vision-language models in the PaddlePaddle ecosystem. It serves models such as ERNIE, ERNIE-4.5, ERNIE-4.5-VL, DeepSeek V3, Qwen3-MoE, Qwen3-VL, and PaddleOCR-VL-0.9B on accelerators.
The concrete problem it addresses is operational complexity in high-throughput model serving. Teams need OpenAI-compatible endpoints, stable latency and throughput targets, heterogeneous accelerators, quantization, disaggregated prefill and decode, KV-cache movement, and speculative decoding without assembling those pieces separately.
Key capabilities
- Load-balanced prefill and decode disaggregation supports context caching and dynamic instance role switching to satisfy service-level objectives and improve resource utilization.
- A unified KV-cache transfer library supports intelligent selection between NVLink and RDMA for moving cache state across serving components.
- The serving layer exposes an OpenAI API and maintains compatibility with vLLM interfaces, allowing single-command deployment of online services.
- Quantization coverage includes W8A16, W8A8, W4A16, W4A8, W2A16, FP8, and the W4AFP8 method introduced in v2.5.
- Acceleration features include speculative decoding, multi-token prediction, chunked prefill, prefix caching, global cache pooling, and a load-balancing router.
- Hardware support spans NVIDIA GPUs, Kunlunxin XPUs, Hygon DCUs, Iluvatar GPUs, Enflame GCUs, MetaX GPUs, and Intel Gaudi accelerators.
- HuggingFace ecosystem model compatibility is listed among recent release capabilities, including support for ERNIE-4.5 and related model families.
Who uses it and how
- Engineering teams deploy production LLM and VLM services through online serving and quick-start guides, then connect clients through OpenAI-compatible endpoints.
- Platform operators running mixed accelerator clusters use the hardware-specific installation paths and serving features to standardize inference across NVIDIA and non-NVIDIA devices.
- Throughput-focused teams apply disaggregated deployment, KV-cache pooling, prefix caching, speculative decoding, and multi-token prediction to reduce serving cost for large models.
- Application teams that need batch or non-interactive processing use the offline inference workflow rather than a persistent API service.
- Model evaluators and integrators use the supported-model list and best-practice guides to run ERNIE, Qwen, DeepSeek, and PaddleOCR-VL workloads.
Getting started
FastDeploy requires Linux and Python 3.10 through 3.12, and its documentation directs users to hardware-specific installation guides for NVIDIA, Kunlunxin, Iluvatar, Enflame, Hygon, MetaX, and Intel Gaudi. Typical usage then follows the quick-start, online serving, and offline inference guides, with single-command deployment mentioned for OpenAI and vLLM-compatible services.
When to use it — and when not to
FastDeploy is most appropriate when the workload sits in the PaddlePaddle ecosystem, targets ERNIE or the listed accelerator families, and needs advanced serving features such as prefill-decode disaggregation, KV-cache transfer, and vLLM-compatible APIs. It is less attractive for projects that require non-Linux deployment, want a narrower NVIDIA-only vLLM stack, or cannot invest in hardware-specific installation and operational tuning. The 649 open issues and the absence of a contributor count indicate that teams should evaluate maintenance readiness before adopting it for critical production services.
project readme (upstream, from github) — read inline
English | 简体中文

安装指导
|
快速入门
|
支持模型列表
FastDeploy 飞桨大模型高效部署套件
最新活动
[2026-03] FastDeploy v2.5 全新发布! 新增Qwen3-VL与Qwen3-VL MoE模型部署支持,新增W4AFP8量化方法,增强强化学习训练支持能力,包含170+项Bug修复与性能优化,升级全部内容参阅 v2.5 ReleaseNote。
[2026-01] FastDeploy v2.4: 新增 DeepSeek V3 与 Qwen3-MoE 模型的 PD 分离部署,增强MTP 投机解码能力,全面优化多硬件平台上的 MoE 推理与多模态前缀缓存性能,升级全部内容参阅 v2.4 ReleaseNote。
[2025-11] FastDeploy v2.3: 新增ERNIE-4.5-VL-28B-A3B-Thinking与PaddleOCR-VL-0.9B两大重磅模型在多硬件平台上的部署支持,进一步优化全方位推理性能,以及带来更多部署功能和易用性的提升,升级全部内容参阅v2.3 ReleaseNote。
[2025-09] FastDeploy v2.2: HuggingFace生态模型兼容,性能进一步优化,更新增对baidu/ERNIE-21B-A3B-Thinking支持!
[2025-08] FastDeploy v2.1:全新的KV Cache调度策略,更多模型支持PD分离和CUDA Graph,昆仑、海光等更多硬件支持增强,全方面优化服务和推理引擎的性能。
关于
FastDeploy 是基于飞桨(PaddlePaddle)的大语言模型(LLM)与视觉语言模型(VLM)推理部署工具包,提供开箱即用的生产级部署方案,核心技术特性包括:
- 🚀 负载均衡式PD分解:工业级解决方案,支持上下文缓存与动态实例角色切换,在保障SLO达标和吞吐量的同时优化资源利用率
- 🔄 统一KV缓存传输:轻量级高性能传输库,支持智能NVLink/RDMA选择
- 🤝 OpenAI API服务与vLLM兼容:单命令部署,兼容vLLM接口
- 🧮 全量化格式支持:W8A16、W8A8、W4A16、W4A8、W2A16、FP8等
- ⏩ 高级加速技术:推测解码、多令牌预测(MTP)及分块预填充
- 🖥️ 多硬件支持:NVIDIA GPU、昆仑芯XPU、海光DCU、天数智芯GPU、燧原GCU、沐曦GPU、英特尔Gaudi等
要求
- 操作系统: Linux
- Python: 3.10 ~ 3.12
安装
FastDeploy 支持在英伟达(NVIDIA)GPU、昆仑芯(Kunlunxin)XPU、天数(Iluvatar)GPU、燧原(Enflame)GCU、海光(Hygon)DCU 以及其他硬件上进行推理部署。详细安装说明如下:
入门指南
通过我们的文档了解如何使用 FastDeploy:
支持模型列表
通过我们的文档了解如何下载模型,如何支持torch格式等:
进阶用法
致谢
FastDeploy 依据 Apache-2.0 开源许可证. 进行授权。在开发过程中,我们参考并借鉴了 vLLM 的部分代码,以保持接口兼容性,在此表示衷心感谢。