远程服务

默认情况下，RPent 会随每次 LIBERO 运行启动并关闭环境、VLA 与 SAM3 服务。单机运行时建议保留这一默认行为。 只有当服务分布在不同主机，或需要跨任务复用 VLA 与 SAM3 模型时，才需要配置外部 endpoint。

三个参数分别设置对应服务的 endpoint：LIBERO 环境用 --env-endpoint， Pi0.5 VLA 用 --vla-endpoint，SAM3 用 --sam3-endpoint。每个都取 [protocol://]HOST:PORT，省略 protocol 时默认 HTTP，也可用 socket:// 改走 socket RPC。

Dashboard Session 不支持 --env-endpoint，因为每个 TaskRun 都需要使用新的 环境服务；Dashboard 模式仍可使用 --vla-endpoint 和 --sam3-endpoint。

LIBERO 环境服务

一个环境服务固定对应一组 suite、task、seed 和最大 episode 步数，这些参数必须与 RPent 客户端完全一致。在环境主机上运行：

export LIBERO_TYPE=pro
python -m robots.libero.env_server \
  --suite libero_object_swap --task 2 --seed 0 \
  --max-episode-steps 10000 \
  --cuda-device 0 \
  --transport http --host 0.0.0.0 --port ENV_PORT

环境服务与任务绑定。需要修改上述任一参数时，请先停止旧服务再重新启动。

Pi0.5 VLA 服务

在 VLA 主机上设置 checkpoint 路径并启动 HTTP 服务：

export PI05_CHECKPOINT_PATH=/path/to/rlinf-pi05-libero-130-fullshot-sft
python -m rpent.robots.components.pi05_vla_server \
  --embodiment libero \
  --cuda-device 0 \
  --transport http --host 0.0.0.0 --port VLA_PORT

VLA 服务只加载一次模型，可以由多个 RPent 运行复用。

SAM3 服务

在 SAM3 主机上设置本地 checkpoint 路径并启动 HTTP 服务：

export SAM3_CHECKPOINT_PATH=/path/to/sam3/sam3.pt
python -m rpent.robots.components.sam3_server \
  --cuda-device 0 \
  --transport http --host 0.0.0.0 --port SAM3_PORT

SAM3 服务只加载一次模型，可以由多个 RPent 运行复用。

连接 RPent

在运行 RPent 的机器上，通过三个 endpoint 参数连接上述服务。suite、task、seed 和最大 episode 步数必须与环境服务的启动参数保持一致：

rpent \
  --robot libero \
  --suite libero_object_swap --task 2 --seed 0 \
  --libero-type pro --max-episode-steps 10000 \
  --env-endpoint http://ENV_HOST:ENV_PORT \
  --vla-endpoint http://VLA_HOST:VLA_PORT \
  --sam3-endpoint http://SAM3_HOST:SAM3_PORT \
  --planner claude_code --model claude-opus-4-8

请将各 *_HOST 替换为运行对应服务的机器地址，并确保运行 RPent 的机器能访问该地址； 将各 *_PORT 替换为启动服务时选择的空闲端口。三个 endpoint 参数可以分别省略， 某项未指定时，RPent 会在当前机器上启动对应服务并自动选择空闲端口。三个服务省略 protocol 时都默认使用 HTTP，也都可以通过 socket://HOST:PORT 改用 socket RPC。

自定义 RLinf 源码

环境服务和 VLA 服务需要导入 rlinf。手动启动时如果使用开发中的 RLinf 源码而非已安装的包，请先把 PYTHONPATH 指向该源码目录：

export PYTHONPATH=/path/to/rlinf:$PYTHONPATH

由 RPent 自动拉起的 server 无需手动设置：RLinf 源码路径从 RPENT_RLINF_ROOT （或 RLINF_REPO_PATH ）解析，默认回退到 RPent 仓库旁边的 rlinf 目录。解析出的路径不存在也无妨：Python 会忽略无效的 PYTHONPATH 条目，server 将导入已安装的 rlinf 包。