4步跑通openpi用Docker搭建VLA机器人模型运行环境【免费下载链接】openpi项目地址: https://gitcode.com/GitHub_Trending/op/openpiopenpi 是 Physical Intelligence 团队开源的 VLA视觉-语言-动作机器人模型仓库内置 π₀、π₀-FAST、π₀.₅ 三类模型开箱即可推理也能微调到自有数据集。按本文做完你的电脑上会有两个正常运行的容器一个策略推理服务器policy server一个 aloha_sim 仿真客户端。成功标准很具体——客户端日志持续打印推理帧率说明模型已在你的 GPU 上跑通。下面用 Docker 部署而不是裸装依赖原因一句话它帮你绕开 ROS 等大型依赖环境一致、不污染系统。 准备清单开始前核对一遍全部满足再动手项目要求系统Ubuntu 22.04 LTS官方只测试了该系统GPUNVIDIA 显卡推理需 8GB 显存官方示例参考 RTX 4090磁盘20GB 以上可用空间镜像 模型缓存Docker需要能跑 rootless 模式snap 安装的 Docker 和 Docker Desktop 与 NVIDIA 容器工具包不兼容二选一都没有才继续1️⃣ 任务一克隆仓库目标拿到完整源码包括 aloha、libero 等子模块缺少子模块会导致示例构建失败。操作一条命令克隆并递归拉取子模块git clone --recurse-submodules https://gitcode.com/GitHub_Trending/op/openpi验证进入目录后能看到scripts/docker/、examples/、third_party/aloha等目录third_party下不是空文件夹。2️⃣ 任务二一键装好Docker目标装好 Docker Engine 并配置好当前用户权限之后跑docker命令不用sudo。操作仓库自带安装脚本一条命令完成加源、装包、加用户组、设开机自启bash scripts/docker/install_docker_ubuntu22.sh脚本跑完会提示重启系统——必须重启否则用户组权限不生效。验证重启后执行下面命令输出里出现 docker 组即成功groups | grep docker3️⃣ 任务三给Docker接上NVIDIA显卡目标让容器能访问 GPU这是模型推理能跑起来的硬前提。操作同样用仓库自带的脚本它负责加 NVIDIA 软件源、装nvidia-container-toolkit、配置 Docker 运行时bash scripts/docker/install_nvidia_container_toolkit.sh验证脚本末尾会自动重启 Docker 服务。装好后可先跑一个最小检查docker run --rm --gpus all nvidia/cuda:12.2.2-base nvidia-smi输出显卡型号和显存信息即 GPU 通道打通。4️⃣ 任务四构建基础镜像并启动策略服务器目标构建openpi_server镜像并启动它模型服务在后台监听等待客户端连入。操作在仓库根目录执行docker compose -f scripts/docker/compose.yml up --build首次构建要拉 CUDA 基础镜像并同步 Python 依赖需要 10~20 分钟之后镜像有缓存启动会快很多。验证终端停在服务器日志处不再退出且docker ps能看到openpi_server容器处于Up状态。如果你的机器没有NVIDIA 显卡需要先把 scripts/docker/compose.yml 里的deployGPU 申请代码块注释掉再启动否则容器会因申请不到 GPU 而起不来。5️⃣ 任务五跑一个能看见结果的示例目标用 aloha_sim 仿真客户端把闭环走通——它向策略服务器发观测模型返回动作仿真画面动起来的瞬间就是跑通。操作--env告诉服务器加载哪个环境的配置然后启动 compose服务器 仿真器一起拉起export SERVER_ARGS--env ALOHA_SIM docker compose -f examples/aloha_sim/compose.yml up --build不想看仿真画面、只想验证推理链路的可以换 examples/simple_client/它是最小客户端。验证客户端日志持续打印观测输入和推理帧率没有断连报错。 排障自查遇到卡住时按现象 → 先查什么 → 怎么处理对号入座现象先查什么怎么处理跑docker报permission denied重启后是否重新登录过用户组要重登录才生效groups \| grep docker确认在组内不在则sudo usermod -aG docker $USER注销重登容器报找不到 GPU /libnvidia-ml.so是否装着 snap 版 Docker 或 Docker Desktop二者与 NVIDIA 工具包冲突用sudo snap remove docker或sudo apt remove docker-desktop移除改回 apt 版 Dockercompose 启动即退、日志有 GPU 相关报错有没有 NVIDIA 卡却保留了 GPU 申请配置注释掉 compose 文件中的deploy块再启动构建慢通常是网络问题可换 Docker 镜像源后重新--build镜像层有缓存不会从头再来。更多细节见 docs/docker.md。下一步打开 examples/ 目录aloha_real真机、droid、libero 各有独立 compose 文件和 README换环境跑法与本文一致想直接用预训练 checkpoint 做推理而不仿真参考 examples/inference.ipynb远程推理模型跑在另一台 GPU 服务器上的接法读 docs/remote_inference.md。【免费下载链接】openpi项目地址: https://gitcode.com/GitHub_Trending/op/openpi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
