VLA 模型开源

π0

Physical Intelligence美国

GitHub 仓库 Physical-Intelligence/openpi

又称 pi0、π0-FAST、π0.5、pi05、openpi

类别
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。版本更新后命令可能变化,以官方文档为准。

  1. 克隆仓库和子模块

    已克隆的话用 git submodule update 补子模块

    git clone --recurse-submodules git@github.com:Physical-Intelligence/openpi.git
  2. 安装依赖

    需先装 uv;环境变量用于拉取 LeRobot;也有 Docker 方案

    GIT_LFS_SKIP_SMUDGE=1 uv sync
    GIT_LFS_SKIP_SMUDGE=1 uv pip install -e .
  3. 计算归一化统计

    以官方 LIBERO 微调示例为例

    uv run scripts/compute_norm_stats.py --config-name pi05_libero
  4. 启动微调

    把 JAX 可用显存从默认 75% 提到 90%

    XLA_PYTHON_CLIENT_MEM_FRACTION=0.9 uv run scripts/train.py pi05_libero --exp-name=my_experiment --overwrite
  5. 启动策略服务

    默认监听 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,官方不支持其他系统
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

rm -rf .venv
uv sync
来源:README.md
Training runs out of GPU memory

解决设 XLA_PYTHON_CLIENT_MEM_FRACTION=0.9 或更高;多卡加 --fsdp-devices <n>;还不够可关 EMA

来源:README.md
Missing norm stats error when training

解决训练前先用配置名跑 compute_norm_stats.py

uv run scripts/compute_norm_stats.py --config-name pi05_libero
来源:README.md
Failed 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 #904
TypeError: 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

获取方式

相关概念

数据来源

本页信息均整理自以下公开资料。

7 条来源核验于 2026-10-01

星标、下载量等指标定期自动更新。

π0(openpi):安装步骤、环境要求与常见报错 | 具身集