开源项目openpi安装与配置指南

1. 项目基础介绍

openpi是一个由Physical Intelligence团队发布的开源项目，它包含了用于机器人的开源模型和包。该项目目前包括两种类型的模型：π₀模型，一种基于流的扩散视觉语言动作模型（VLA）；以及π₀-FAST模型，一种基于FAST动作标记器的自回归VLA。

项目主要使用的编程语言是Python。

2. 项目使用的关键技术和框架

• 流式扩散模型：用于处理视觉、语言和动作的模型。
• 自回归模型：在π₀-FAST模型中用于提高动作生成的效率。
• LeRobot数据格式：用于训练的数据集格式。
• uv工具：用于管理Python依赖和虚拟环境。

3. 项目安装和配置准备工作

在开始安装前，请确保您的系统满足以下要求：

• 操作系统：Ubuntu 22.04
• GPU：NVIDIA GPU，具体要求见项目文档
• Python环境：建议使用Python 3.8以上版本

以下为详细安装步骤：

步骤1：克隆项目仓库

首先，需要克隆项目仓库，并更新子模块：

git clone --recurse-submodules [e-mail]:Physical-Intelligence/openpi.git

如果已经克隆了仓库，可以使用以下命令更新子模块：

git submodule update --init --recursive

步骤2：安装uv工具

uv工具用于管理Python依赖和虚拟环境。按照以下步骤安装uv：

• 访问uv的GitHub页面或官方网站获取安装说明。
• 按照官方文档指引完成uv的安装。

步骤3：配置虚拟环境

在项目目录中，使用uv命令创建和激活虚拟环境：

GIT_LFS_SKIP_SMUDGE=1 uv sync

然后安装项目依赖：

GIT_LFS_SKIP_SMUDGE=1 uv pip install -e .

请注意，环境变量GIT_LFS_SKIP_SMUDGE=1是必须的，用于正确地拉取依赖。

步骤4：运行示例代码

安装完成后，您可以通过项目提供的示例代码来测试环境是否配置正确。

以上步骤为openpi项目的安装和配置提供了详细指南，按照这些步骤，即使是编程小白也可以顺利完成安装和配置工作。