# Hello Robot Stretch：stretch_body Python API 快速上手

> 原文链接：https://robotics.hellobike.com/tutorials/hello-robot-stretch-body-quickstart
> 频道：tutorials | 更新日期：2026-10-22 | 标签：Hello Robot, Stretch, stretch_body, Python3, pip3
> 核心摘要：本文基于 stretch_body README，面向 Stretch 1-3 机器人，完成 Python3 包与命令行工具安装，并说明仓库包含的核心包、适用范围和后续测试开发入口。

# Hello Robot Stretch：stretch_body Python API 快速上手

> 本文依据以下官方文档整理：[raw.githubusercontent.com/hello-robot/stretch_body/master/RE](https://raw.githubusercontent.com/hello-robot/stretch_body/master/README.md)。命令与版本以文档当前版本为准。

## 前置条件

- Hello Robot Stretch 1-3 robots
- Python3
- pip3

## 1. 确认适用的 Stretch 机器人

stretch_body repository includes Python packages that allow a developer to interact with the hardware of the Stretch 1-3 robots。若使用 Stretch 4，文档明确指向另一个 repository。

## 2. 了解仓库包含的两个包

该 repository 包含 hello-robot-stretch-body 与 hello-robot-stretch-body-tools。前者是 Python library to interface with Stretch，后者是 Useful commandline tools for using Stretch。

## 3. 安装 Stretch Python library

Python3 version of packages can be installed by 下面命令。此包名必须使用 README 中的 hello-robot-stretch-body，用于通过 Python library 接口连接 Stretch。
```bash
pip3 install -U hello-robot-stretch-body
```

## 4. 安装 Stretch 命令行工具

继续安装 README 中列出的 hello-robot-stretch-body-tools。该包提供 Useful commandline tools for using Stretch，与 Python library 配套用于 Stretch。
```bash
pip3 install -U hello-robot-stretch-body-tools
```

## 5. 进入测试与开发入口

Testing and Development 部分给出了两个入口：Stretch Body's README 用于 stretch_body 包测试开发信息，Stretch Body Commandline Tool's README 用于命令行工具测试开发信息。

## 验证是否跑通

确认两条 Python3 安装命令均已完成：pip3 install -U hello-robot-stretch-body 与 pip3 install -U hello-robot-stretch-body-tools。README 对应说明为前者可 interface with Stretch，后者提供 commandline tools for using Stretch。

## 文档里点名的注意事项

- Looking for the Stretch 4 repository? Check out https://github.com/hello-robot/stretch4_body
- This software is intended for use with the Stretch mobile manipulators, which are robots produced and sold by Hello Robot Inc.
- Each subdirectory contains a LICENSE.md file that applies to the directory's contents.

## 原始参考来源 (Sources)

- [raw.githubusercontent.com/hello-robot/stretch_body/master/README.md](https://raw.githubusercontent.com/hello-robot/stretch_body/master/README.md)