硬件要求
安装 FastDeploy CPU 版本 的硬件和软件环境要求如下,结合官方文档和常见实践整理:
1. 硬件要求
- CPU :支持 x86 或 ARM 架构(如 Intel/AMD CPU 或 RK3588 等 ARM 芯片)。
- 若使用 NPU/GPU 加速(非必须),需硬件支持(如香橙派 RK3588 的 NPU),但纯 CPU 部署无需额外硬件。
- 内存:建议 ≥8GB(根据模型复杂度调整,大模型需更多内存)。
2. 软件环境
操作系统
- Linux(推荐):Ubuntu 20.04/22.04 或 CentOS 7/8。
- Windows/macOS:部分场景支持,但官方推荐 Linux 以获得最佳稳定性。
依赖项
- Python :3.7/3.8/3.9/3.10(推荐使用虚拟环境,如
conda或venv)。 - pip :升级到最新版本(
pip install --upgrade pip)。 - 编译器 (源码编译时需要):
- Linux:
gcc≥7.0(Ubuntu 需安装build-essential)。 - Windows:Visual Studio 2019 或更高版本。
- Linux:
3. 安装方式
方法 1:直接使用 pip 安装(推荐)
# CPU 版本(自动下载预编译包)
pip install fastdeploy-python -f https://www.paddlepaddle.org.cn/whl/fastdeploy.html
提示 :若需指定版本(如 1.0.1),替换包名为
fastdeploy-python==1.0.1。
方法 2:源码编译(高级用户)
-
克隆仓库:
git clone https://github.com/PaddlePaddle/FastDeploy.git cd FastDeploy -
编译(以 Linux 为例):
mkdir build && cd build cmake .. -DFASTDEPLOY_INSTALL_DIR=/path/to/install make -j$(nproc) make install详细步骤参考 官方编译文档。
4. 环境校验
安装后运行以下命令验证:
import fastdeploy
print(fastdeploy.__version__) # 输出版本号即成功
5. 常见问题
- 报错
No module named 'fastdeploy':检查 Python 环境是否匹配,或尝试pip uninstall fastdeploy后重新安装。 - Linux 权限问题 :在安装命令前加
sudo(不推荐),或使用--user参数安装到用户目录。 - 兼容性:若使用旧版 Python/操作系统,建议通过源码编译或升级系统。
如需进一步优化性能(如模型量化),可参考 FastDeploy 官方文档 中的高级配置。
帮我写一个fastdeploy部署项目
待续