- 类别
- VLA 模型
- 开放程度
- 开源
- 发布时间
- 2024 年 10 月
- 开源协议
- Apache-2.0
- 发布方所在地
- 美国
项目简介
π0 系列是 Physical Intelligence 的通用机器人 VLA 模型,openpi 仓库提供官方代码和开源权重:基于流匹配的 π0、基于 FAST 动作分词器的自回归模型 π0-FAST,以及开放世界泛化更好的 π0.5。仓库提供在 1 万小时以上机器人数据上预训练的基础模型和 DROID、ALOHA、LIBERO 微调检查点,支持 JAX 与 PyTorch 训练、LoRA 微调和策略推理服务。
- 规模
- 包含 π0、π0-FAST、π0.5 三个模型;基础模型在 1 万小时以上的机器人数据上预训练
π0 安装要点
来源:README.md依据官方资料的 main 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
克隆仓库和子模块
已克隆的话用 git submodule update 补子模块
git clone --recurse-submodules git@github.com:Physical-Intelligence/openpi.git安装依赖
需先装 uv;环境变量用于拉取 LeRobot;也有 Docker 方案
GIT_LFS_SKIP_SMUDGE=1 uv sync GIT_LFS_SKIP_SMUDGE=1 uv pip install -e .计算归一化统计
以官方 LIBERO 微调示例为例
uv run scripts/compute_norm_stats.py --config-name pi05_libero启动微调
把 JAX 可用显存从默认 75% 提到 90%
XLA_PYTHON_CLIENT_MEM_FRACTION=0.9 uv run scripts/train.py pi05_libero --exp-name=my_experiment --overwrite启动策略服务
默认监听 8000 端口
uv run scripts/serve_policy.py policy:checkpoint --policy.config=pi05_libero --policy.dir=checkpoints/pi05_libero/my_experiment/20000
环境要求
来源:README.md- 操作系统
- Ubuntu 22.04,官方不支持其他系统
- Python来源:pyproject.toml
- >= 3.11
- GPU
- NVIDIA GPU;显存是单卡估算,可用 fsdp_devices 分摊到多卡
- 推理显存
- > 8 GB,示例 RTX 4090
- LoRA 微调显存
- > 22.5 GB,示例 RTX 4090
- 全量微调显存
- > 70 GB,示例 A100 80GB、H100
- CUDA
- 系统不用装 CUDA 库,由 uv 安装
适配矩阵
来源:README.md官方权重的用途;PyTorch 列按模型族写,权重要先从 JAX 转换
| 名称 | 推理 | 微调 | PyTorch |
|---|---|---|---|
| π0 base | — | ✓ | ✓ |
| π0-FAST base | — | ✓ | 不支持 |
| π0.5 base | — | ✓ | ✓ |
| π0-FAST-DROID | ✓ | — | 不支持 |
| π0-DROID | — | ✓ | ✓ |
| π0-ALOHA-towel | ✓ | — | ✓ |
| π0-ALOHA-tupperware | ✓ | — | ✓ |
| π0-ALOHA-pen-uncap | ✓ | — | ✓ |
| π0.5-LIBERO | ✓ | — | ✓ |
| π0.5-DROID | ✓ | ✓ | ✓ |
✓ 官方资料写明支持,— 资料没写。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
`uv sync` fails with dependency conflicts解决删掉 .venv 后重跑 uv sync;仍失败就用 uv self update 升级 uv
来源:README.mdrm -rf .venv uv syncTraining runs out of GPU memory解决设 XLA_PYTHON_CLIENT_MEM_FRACTION=0.9 或更高;多卡加 --fsdp-devices <n>;还不够可关 EMA
来源:README.mdMissing norm stats error when training解决训练前先用配置名跑 compute_norm_stats.py
来源:README.mduv run scripts/compute_norm_stats.py --config-name pi05_liberoFailed to build av==14.4.0原因PyPI 下架了 av 14.4.0 的 wheel,源码编译要 FFmpeg 7
解决在 pyproject.toml 的 [tool.uv] override-dependencies 里加 av==14.3.0,再 uv sync
来源:Issue #904TypeError: stack(): argument 'tensors' (position 1) must be tuple of Tensors, not Column原因datasets 4.0.0 的破坏性改动
解决把 datasets 固定到 3.6.0
来源:Issue #561
适配机器人
- ALOHA
- DROID Franka
- UR5