# Роботы

Каждый робот в LeRobot реализует интерфейс `Robot`: подключение, чтение наблюдения, отправка действия, отключение. Написание политики или скрипта записи для этого интерфейса означает, что он будет работать с любой поддерживаемой манипулятором без изменений.

Эта страница содержит сгенерированную справочную информацию. Для инструкций по подключению, калибровке и первому запуску начните с руководств по аппаратному обеспечению — [SO-101](../so101), [LeKiwi](../lekiwi), [Hope Jr](../hope_jr), [Reachy 2](../reachy2), [OpenArm](../openarm) — или с [Imitation Learning for Robots](../il_robots) для сквозного рабочего процесса. Для роботов, поддерживаемых сообществом и не входящих в основной набор, см. [Third-Party Robots & Teleoperators](../third_party_robots). Чтобы добавить собственный робот, см. [Bring Your Own Hardware](../integrate_hardware).

## Робот[[lerobot.robots.Robot]]

Абстрактный базовый класс. Подклассы реализуют каждый из методов, описанных ниже; контракт, описанный здесь, является тем, на что может полагаться политика или цикл записи.

#### lerobot.robots.Robot[[lerobot.robots.Robot]]

```python
lerobot.robots.Robot(config: RobotConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/robot.py#L33)

**Параметры:**

config_class (RobotConfig) : Ожидаемый класс конфигурации для этого робота.

name (str) : Уникальное имя робота, используемое для идентификации этого типа робота.

Базовый абстрактный класс для всех роботов, совместимых с LeRobot.

Этот класс предоставляет стандартизированный интерфейс для взаимодействия с физическими роботами. Подклассы должны реализовать все абстрактные методы и свойства, чтобы быть пригодными для использования.

#### подключить[[lerobot.robots.Robot.connect]]

```python
connect(calibrate: bool = True)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/robot.py#L136)

**Параметры:**

calibrate (bool) : Если True, робот будет автоматически калиброваться после подключения, если он не откалиброван или требует калибровки (зависит от аппаратной части).

Установите связь с роботом.

#### отключить[[lerobot.robots.Robot.disconnect]]

```python
disconnect()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/robot.py#L237)

Отключитесь от робота и выполните необходимую очистку.

#### настроить[[lerobot.robots.Robot.configure]]

```python
configure()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/robot.py#L202)

Примените любую одноразовую или конфигурацию во время выполнения для робота. Это может включать в себя настройку параметров двигателей, режимов управления или начального состояния.

#### калибровать[[lerobot.robots.Robot.calibrate]]

```python
calibrate()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/robot.py#L153)

Откалибруйте робота, если это применимо. В противном случае эта операция не должна ничего делать.

Этот метод должен собирать все необходимые данные (например, смещения моторов) и соответствующим образом обновлять словарь :pyattr:`calibration`.

#### get_observation[[lerobot.robots.Robot.get_observation]]

```python
get_observation()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/robot.py#L210)

**Возвращает:** `RobotObservation`

Плоский словарь, представляющий текущее сенсорное состояние робота. Его структура должна соответствовать :pymeth:`observation_features`.

Получите текущее наблюдение от робота.

#### send_action[[lerobot.robots.Robot.send_action]]

```python
send_action(action: dict)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/robot.py#L222)

**Параметры:**

action (RobotAction) : словарь, описывающий требуемое действие. Его структура должна соответствовать :pymeth:`action_features`.

**Возвращает:** `RobotAction`

Действие, фактически отправленное на моторы, может быть обрезано или изменено, например, из-за ограничений безопасности по скорости.

Отправьте команду действия роботу.

#### observation_features[[lerobot.robots.Robot.observation_features]]

```python
observation_features()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/robot.py#L100)

Словарь, описывающий структуру и типы наблюдений, генерируемых роботом. Его структура (ключи) должна соответствовать структуре данных, возвращаемых методом :pymeth:`get_observation`. Значения в словаре должны быть:
- Тип значения, если это простое значение, например `float` для единичного проприоцептивного значения (позиция/скорость сустава)
- Кортеж, представляющий форму, если значение имеет тип массива, например `(height, width, channel)` для изображений

Примечание: этот метод должен вызываться независимо от того, подключен ли робот или нет.

#### action_features[[lerobot.robots.Robot.action_features]]

```python
action_features()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/robot.py#L114)

Словарь, описывающий структуру и типы действий, ожидаемых роботом. Его структура (ключи) должна соответствовать структуре данных, передаваемых в :pymeth:`send_action`. Значения в словаре должны указывать тип значения, если это простое значение, например `float` для одиночного проприоцептивного значения (целевая позиция/скорость сустава)

Примечание: этот метод должен вызываться независимо от того, подключен ли робот или нет.

#### is_connected[[lerobot.robots.Robot.is_connected]]

```python
is_connected()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/robot.py#L127)

Указывает, подключён ли робот в данный момент. Если `False`, вызов :pymeth:`get_observation` или :pymeth:`send_action` должен вызывать ошибку.

#### is_calibrated[[lerobot.robots.Robot.is_calibrated]]

```python
is_calibrated()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/robot.py#L147)

Указывает, откалиброван ли робот в данный момент. Если не применимо, должно всегда быть `True`

## RobotConfig[[lerobot.robots.RobotConfig]]

#### lerobot.robots.RobotConfig[[lerobot.robots.RobotConfig]]

```python
lerobot.robots.RobotConfig(id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/config.py#L23)

## make_robot_from_config[[lerobot.robots.make_robot_from_config]]

#### lerobot.robots.make_robot_from_config[[lerobot.robots.make_robot_from_config]]

```python
lerobot.robots.make_robot_from_config(config: RobotConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/utils.py#L28)

## Следующие за SO-100 и SO-101[[lerobot.robots.so_follower.SOFollower]]

`SO100Follower` и `SO101Follower` являются псевдонимами одного и того же класса `SOFollower`; два манипулятора различаются конфигурацией, а не кодом управления. `SO100FollowerConfig` и `SO101FollowerConfig` аналогично являются псевдонимами `SOFollowerRobotConfig`.

#### lerobot.robots.so_follower.SOFollower[[lerobot.robots.so_follower.SOFollower]]

```python
lerobot.robots.so_follower.SOFollower(config: SOFollowerRobotConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/so_follower/so_follower.py#L54)

Базовый класс SO follower, реализующий общую функциональность для SO-100/101/10X. Предназначен для наследования с указанием `config_class` и `name` для каждой модели оборудования.

#### подключить[[lerobot.robots.so_follower.SOFollower.connect]]

```python
connect(calibrate: bool = True)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/so_follower/so_follower.py#L110)

Мы предполагаем, что в момент подключения рука находится в покое, и момент вращения можно безопасно отключить для выполнения калибровки.

#### send_action[[lerobot.robots.so_follower.SOFollower.send_action]]

```python
send_action(action: dict)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/so_follower/so_follower.py#L187)

**Возвращает:** `RobotAction`

действие, отправляемое на моторы, возможно, обрезанное.

**Исключения:** ``RobotDeviceNotConnectedError``

- ``RobotDeviceNotConnectedError`` -- если робот не подключен.

Команда для перемещения манипулятора в целевую конфигурацию суставов.

Относительная величина действия может быть ограничена в зависимости от параметра конфигурации `max_relative_target`. В этом случае отправляемое действие отличается от исходного. Таким образом, эта функция всегда возвращает действие, которое было фактически отправлено.

#### lerobot.robots.so_follower.SOFollowerRobotConfig[[lerobot.robots.so_follower.SOFollowerRobotConfig]]

```python
lerobot.robots.so_follower.SOFollowerRobotConfig(port: str, disable_torque_on_disconnect: bool = True, max_relative_target: float | dict[str, float] | None = None, cameras: dict = <factory>, use_degrees: bool = True, position_p_coefficient: int = 16, position_i_coefficient: int = 0, position_d_coefficient: int = 32, num_read_retries: int = 2, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/so_follower/config_so_follower.py#L59)

## BiSOFollower[[lerobot.robots.bi_so_follower.BiSOFollower]]

Два последователя SO, управляемые как единый двуручный робот.

#### lerobot.robots.bi_so_follower.BiSOFollower[[lerobot.robots.bi_so_follower.BiSOFollower]]

```python
lerobot.robots.bi_so_follower.BiSOFollower(config: BiSOFollowerConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/bi_so_follower/bi_so_follower.py#L31)

[Двуручные манипуляторы SO Follower Arms](https://github.com/TheRobotStudio/SO-ARM100), разработанные TheRobotStudio

#### lerobot.robots.bi_so_follower.BiSOFollowerConfig[[lerobot.robots.bi_so_follower.BiSOFollowerConfig]]

```python
lerobot.robots.bi_so_follower.BiSOFollowerConfig(left_arm_config: SOFollowerConfig, right_arm_config: SOFollowerConfig, cameras: dict = <factory>, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/bi_so_follower/config_bi_so_follower.py#L27)

Класс конфигурации для роботов Bi SO Follower.

## KochFollower[[lerobot.robots.koch_follower.KochFollower]]

#### lerobot.robots.koch_follower.KochFollower[[lerobot.robots.koch_follower.KochFollower]]

```python
lerobot.robots.koch_follower.KochFollower(config: KochFollowerConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/koch_follower/koch_follower.py#L33)

- [Koch v1.0](https://github.com/AlexanderKoch-Koch/low_cost_robot), с расширением от запястья до локтя и без него, разработанный Александром Кохом из [Tau Robotics](https://tau-robotics.com)
- [Koch v1.1](https://github.com/jess-moss/koch-v1-1), разработанный Джесс Мосс

#### подключить[[lerobot.robots.koch_follower.KochFollower.connect]]

```python
connect(calibrate: bool = True)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/koch_follower/koch_follower.py#L89)

Мы предполагаем, что в момент подключения рука находится в покое, и момент вращения можно безопасно отключить для выполнения калибровки.

#### send_action[[lerobot.robots.koch_follower.KochFollower.send_action]]

```python
send_action(action: dict)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/koch_follower/koch_follower.py#L176)

**Параметры:**

action (RobotAction) : Целевые положения для моторов.

**Возвращает:** `RobotAction`

Действие, отправляемое на моторы, возможно, обрезанное.

Команда для перемещения манипулятора в целевую конфигурацию суставов.

Относительная величина действия может быть ограничена в зависимости от параметра конфигурации `max_relative_target`. В этом случае отправляемое действие отличается от исходного. Таким образом, эта функция всегда возвращает действие, которое было фактически отправлено.

#### lerobot.robots.koch_follower.KochFollowerConfig[[lerobot.robots.koch_follower.KochFollowerConfig]]

```python
lerobot.robots.koch_follower.KochFollowerConfig(port: str, disable_torque_on_disconnect: bool = True, max_relative_target: float | dict[str, float] | None = None, cameras: dict = <factory>, use_degrees: bool = False, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/koch_follower/config_koch_follower.py#L24)

## LeKiwi[[lerobot.robots.lekiwi.LeKiwi]]

`LeKiwi` работает непосредственно на роботе. `LeKiwiClient` — это прокси на стороне хоста, который взаимодействует с ним по сети и предоставляет тот же интерфейс `Robot`.

#### lerobot.robots.lekiwi.LeKiwi[[lerobot.robots.lekiwi.LeKiwi]]

```python
lerobot.robots.lekiwi.LeKiwi(config: LeKiwiConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/lekiwi/lekiwi.py#L36)

Робот включает в себя мобильную базу с тремя омниколесами и удалённую манипуляторную руку-исполнитель. Рука-оператор подключена локально (к ноутбуку), её положения суставов записываются, а затем передаются на удалённую руку-исполнитель (после применения ограничителя безопасности). Параллельно для генерации сырых команд скорости для колёс используется телеуправление с клавиатуры.

#### send_action[[lerobot.robots.lekiwi.LeKiwi.send_action]]

```python
send_action(action: dict)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/lekiwi/lekiwi.py#L339)

**Возвращает:** `RobotAction`

действие, отправляемое на моторы, возможно, обрезанное.

**Исключения:** ``RobotDeviceNotConnectedError``

- ``RobotDeviceNotConnectedError`` -- если робот не подключен.

Команда lekiwi для перемещения в целевую конфигурацию суставов.

Относительная величина действия может быть ограничена в зависимости от параметра конфигурации `max_relative_target`. В этом случае отправляемое действие отличается от исходного. Таким образом, эта функция всегда возвращает действие, которое было фактически отправлено.

#### lerobot.robots.lekiwi.LeKiwiConfig[[lerobot.robots.lekiwi.LeKiwiConfig]]

```python
lerobot.robots.lekiwi.LeKiwiConfig(port: str = '/dev/ttyACM0', disable_torque_on_disconnect: bool = True, max_relative_target: float | dict[str, float] | None = None, cameras: dict = <factory>, use_degrees: bool = True, num_read_retries: int = 2, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/lekiwi/config_lekiwi.py#L47)

#### lerobot.robots.lekiwi.LeKiwiClient[[lerobot.robots.lekiwi.LeKiwiClient]]

```python
lerobot.robots.lekiwi.LeKiwiClient(config: LeKiwiClientConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/lekiwi/lekiwi_client.py#L40)

#### подключить[[lerobot.robots.lekiwi.LeKiwiClient.connect]]

```python
connect()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/lekiwi/lekiwi_client.py#L129)

Устанавливает сокеты ZMQ с удалённым мобильным роботом

#### отключить[[lerobot.robots.lekiwi.LeKiwiClient.disconnect]]

```python
disconnect()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/lekiwi/lekiwi_client.py#L351)

Очистка ZMQ-соединений

#### get_observation[[lerobot.robots.lekiwi.LeKiwiClient.get_observation]]

```python
get_observation()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/lekiwi/lekiwi_client.py#L269)

Получение наблюдений от удалённого робота: текущие позиции звеньев манипулятора, текущие скорости колёс (преобразованные в скорости в системе координат корпуса: x, y, theta) и кадр с камеры. Получение данных по ZMQ, преобразование в скорости в системе координат корпуса

#### send_action[[lerobot.robots.lekiwi.LeKiwiClient.send_action]]

```python
send_action(action: dict)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/lekiwi/lekiwi_client.py#L323)

**Параметры:**

action (RobotAction) : массив, содержащий целевые позиции для моторов.

**Возвращает:** `np.ndarray`

действие, отправляемое на моторы, возможно, обрезанное.

**Исключения:** ``RobotDeviceNotConnectedError``

- ``RobotDeviceNotConnectedError`` -- если робот не подключен.

Команда lekiwi для перемещения в целевую конфигурацию суставов. Преобразует в пространство моторов + отправляет через ZMQ

#### lerobot.robots.lekiwi.LeKiwiClientConfig[[lerobot.robots.lekiwi.LeKiwiClientConfig]]

```python
lerobot.robots.lekiwi.LeKiwiClientConfig(remote_ip: str, port_zmq_cmd: int = 5555, port_zmq_observations: int = 5556, teleop_keys: dict = <factory>, cameras: dict = <factory>, polling_timeout_ms: int = 15, connect_timeout_s: int = 5, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/lekiwi/config_lekiwi.py#L87)

## OpenArmFollower[[lerobot.robots.openarm_follower.OpenArmFollower]]

#### lerobot.robots.openarm_follower.OpenArmFollower[[lerobot.robots.openarm_follower.OpenArmFollower]]

```python
lerobot.robots.openarm_follower.OpenArmFollower(config: OpenArmFollowerConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/openarm_follower/openarm_follower.py#L40)

Робот-последователь OpenArms Follower, использующий коммуникацию по шине CAN для управления 7-осевой рукой с захватом. Рука оснащена моторами Damiao, работающими в режиме управления MIT.

#### калибровать[[lerobot.robots.openarm_follower.OpenArmFollower.calibrate]]

```python
calibrate()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/openarm_follower/openarm_follower.py#L164)

Запустите процедуру калибробот OpenArms.

Процедура калибровки:
1. Отключить крутящий момент
2. Попросите пользователя расположить руки в подвешенном положении со сжатыми захватами
3. Установите это как нулевую позицию
4. Запишите диапазон движения для каждого сустава
5. Сохранить калибровку

#### настроить[[lerobot.robots.openarm_follower.OpenArmFollower.configure]]

```python
configure()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/openarm_follower/openarm_follower.py#L215)

Настройте моторы с соответствующими параметрами.

#### подключить[[lerobot.robots.openarm_follower.OpenArmFollower.connect]]

```python
connect(calibrate: bool = True)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/openarm_follower/openarm_follower.py#L130)

Подключитесь к роботу и при необходимости выполните калибровку.

Мы предполагаем, что в момент подключения манипуляторы находятся в безопасном положении покоя, а момент вращения может быть безопасно отключен для выполнения калибровки при необходимости.

#### отключить[[lerobot.robots.openarm_follower.OpenArmFollower.disconnect]]

```python
disconnect()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/openarm_follower/openarm_follower.py#L345)

Отключитесь от робота.

#### get_observation[[lerobot.robots.openarm_follower.OpenArmFollower.get_observation]]

```python
get_observation()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/openarm_follower/openarm_follower.py#L226)

Получить текущее наблюдение от робота, включая позицию, скорость и момент силы.

Читает все состояния моторов (pos/vel/torque) за один цикл обновления CAN, а не тремя отдельными запросами.

#### send_action[[lerobot.robots.openarm_follower.OpenArmFollower.send_action]]

```python
send_action(action: dict, custom_kp: dict[str, float] | None = None, custom_kd: dict[str, float] | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/openarm_follower/openarm_follower.py#L266)

**Параметры:**

action : Словарь с позициями моторов (например, "joint_1.pos", "joint_2.pos")

custom_kp : Необязательные пользовательские коэффициенты усиления kp для каждого мотора (например, {"joint_1": 120.0, "joint_2": 150.0})

custom_kd : Необязательные пользовательские коэффициенты усиления kd для каждого мотора (например, {"joint_1": 1.5, "joint_2": 2.0})

**Возвращает:**

Действие, фактически отправленное (возможно, обрезанное)

Отправить команду действия роботу.

Амплитуда действия может быть ограничена в соответствии с предельными значениями безопасности.

#### lerobot.robots.openarm_follower.OpenArmFollowerConfig[[lerobot.robots.openarm_follower.OpenArmFollowerConfig]]

```python
lerobot.robots.openarm_follower.OpenArmFollowerConfig(port: str, side: str | None = None, can_interface: str = 'socketcan', use_can_fd: bool = True, can_bitrate: int = 1000000, can_data_bitrate: int = 5000000, disable_torque_on_disconnect: bool = True, use_velocity_and_torque: bool = False, max_relative_target: float | dict[str, float] | None = None, cameras: dict = <factory>, motor_config: dict = <factory>, position_kp: list = <factory>, position_kd: list = <factory>, joint_limits: dict = <factory>, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/openarm_follower/config_openarm_follower.py#L125)

## BiOpenArmFollower[[lerobot.robots.bi_openarm_follower.BiOpenArmFollower]]

#### lerobot.robots.bi_openarm_follower.BiOpenArmFollower[[lerobot.robots.bi_openarm_follower.BiOpenArmFollower]]

```python
lerobot.robots.bi_openarm_follower.BiOpenArmFollower(config: BiOpenArmFollowerConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/bi_openarm_follower/bi_openarm_follower.py#L31)

Двуручные манипуляторы OpenArm Follower

#### lerobot.robots.bi_openarm_follower.BiOpenArmFollowerConfig[[lerobot.robots.bi_openarm_follower.BiOpenArmFollowerConfig]]

```python
lerobot.robots.bi_openarm_follower.BiOpenArmFollowerConfig(id: str | None = 'bi_openarm_follower', calibration_dir: pathlib.Path | None = None, left_arm_config: OpenArmFollowerConfigBase, right_arm_config: OpenArmFollowerConfigBase, cameras: dict = <factory>)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/bi_openarm_follower/config_bi_openarm_follower.py#L27)

Класс конфигурации для роботов Bi OpenArm Follower.

## OmxFollower[[lerobot.robots.omx_follower.OmxFollower]]

#### lerobot.robots.omx_follower.OmxFollower[[lerobot.robots.omx_follower.OmxFollower]]

```python
lerobot.robots.omx_follower.OmxFollower(config: OmxFollowerConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/omx_follower/omx_follower.py#L33)

- [OMX](https://github.com/ROBOTIS-GIT/open_manipulator), расширение, разработанное Woojin Wie и Junha Cha из [ROBOTIS](https://ai.robotis.com/)

#### подключить[[lerobot.robots.omx_follower.OmxFollower.connect]]

```python
connect(calibrate: bool = True)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/omx_follower/omx_follower.py#L89)

Для роботов OMX, поставляемых с заводской калибровкой:
- Если калибровка по умолчанию из пакета не соответствует моторам, считайте данные с моторов и сохраните их
- Это позволяет использовать предварительно откалиброванных роботов без ручной калибровки
- Если файл калибровки не существует, используйте значения по умолчанию (homing_offset=0, range_min=0, range_max=4095)

#### send_action[[lerobot.robots.omx_follower.OmxFollower.send_action]]

```python
send_action(action: dict)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/omx_follower/omx_follower.py#L190)

**Параметры:**

action (RobotAction) : Целевые положения для моторов.

**Возвращает:** `RobotAction`

Действие, отправляемое на моторы, возможно, обрезанное.

Команда для перемещения манипулятора в целевую конфигурацию суставов.

Относительная величина действия может быть ограничена в зависимости от параметра конфигурации `max_relative_target`. В этом случае отправляемое действие отличается от исходного. Таким образом, эта функция всегда возвращает действие, которое было фактически отправлено.

#### lerobot.robots.omx_follower.OmxFollowerConfig[[lerobot.robots.omx_follower.OmxFollowerConfig]]

```python
lerobot.robots.omx_follower.OmxFollowerConfig(port: str, disable_torque_on_disconnect: bool = True, max_relative_target: float | dict[str, float] | None = None, cameras: dict = <factory>, use_degrees: bool = False, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/omx_follower/config_omx_follower.py#L24)

## Reachy2Robot[[lerobot.robots.reachy2.Reachy2Robot]]

#### lerobot.robots.reachy2.Reachy2Robot[[lerobot.robots.reachy2.Reachy2Robot]]

```python
lerobot.robots.reachy2.Reachy2Robot(config: Reachy2RobotConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/reachy2/robot_reachy2.py#L75)

[Reachy 2](https://www.pollen-robotics.com/reachy/) от Pollen Robotics.

#### lerobot.robots.reachy2.Reachy2RobotConfig[[lerobot.robots.reachy2.Reachy2RobotConfig]]

```python
lerobot.robots.reachy2.Reachy2RobotConfig(max_relative_target: float | None = None, ip_address: str | None = 'localhost', port: int = 50065, disable_torque_on_disconnect: bool = False, use_external_commands: bool = False, with_mobile_base: bool = True, with_l_arm: bool = True, with_r_arm: bool = True, with_neck: bool = True, with_antennas: bool = True, with_left_teleop_camera: bool = False, with_right_teleop_camera: bool = False, with_torso_camera: bool = False, camera_width: int = 640, camera_height: int = 480, cameras: dict = <factory>, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/reachy2/configuration_reachy2.py#L25)

## UnitreeG1[[lerobot.robots.unitree_g1.UnitreeG1]]

#### lerobot.robots.unitree_g1.UnitreeG1[[lerobot.robots.unitree_g1.UnitreeG1]]

```python
lerobot.robots.unitree_g1.UnitreeG1(config: UnitreeG1Config)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/unitree_g1/unitree_g1.py#L155)

#### lerobot.robots.unitree_g1.UnitreeG1Config[[lerobot.robots.unitree_g1.UnitreeG1Config]]

```python
lerobot.robots.unitree_g1.UnitreeG1Config(kp: list[float] | None = None, kd: list[float] | None = None, default_positions: list = <factory>, control_dt: float = 0.004, is_simulation: bool = True, end_effector: G1EndEffector = <G1EndEffector.DEX1: 'dex1'>, sim_publish_images: bool = True, sim_camera_port: int = 5555, sim_onscreen: bool | None = None, robot_ip: str = '192.168.123.164', cameras: dict = <factory>, gravity_compensation: bool = False, controller: str | None = None, embodiment: str = 'g1_29', id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/unitree_g1/config_unitree_g1.py#L30)

## Hope Jr[[lerobot.robots.hope_jr.HopeJrArm]]

Гуманоид Hope Jr представлен в виде двух независимых роботов: руки и кисти.

#### lerobot.robots.hope_jr.HopeJrArm[[lerobot.robots.hope_jr.HopeJrArm]]

```python
lerobot.robots.hope_jr.HopeJrArm(config: HopeJrArmConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/hope_jr/hope_jr_arm.py#L34)

#### подключить[[lerobot.robots.hope_jr.HopeJrArm.connect]]

```python
connect(calibrate: bool = True)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/hope_jr/hope_jr_arm.py#L88)

Мы предполагаем, что в момент подключения рука находится в покое, и момент вращения можно безопасно отключить для выполнения калибровки.

#### lerobot.robots.hope_jr.HopeJrArmConfig[[lerobot.robots.hope_jr.HopeJrArmConfig]]

```python
lerobot.robots.hope_jr.HopeJrArmConfig(port: str, disable_torque_on_disconnect: bool = True, max_relative_target: float | dict[str, float] | None = None, cameras: dict = <factory>, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/hope_jr/config_hope_jr.py#L42)

#### lerobot.robots.hope_jr.HopeJrHand[[lerobot.robots.hope_jr.HopeJrHand]]

```python
lerobot.robots.hope_jr.HopeJrHand(config: HopeJrHandConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/hope_jr/hope_jr_hand.py#L58)

#### lerobot.robots.hope_jr.HopeJrHandConfig[[lerobot.robots.hope_jr.HopeJrHandConfig]]

```python
lerobot.robots.hope_jr.HopeJrHandConfig(port: str, side: str, disable_torque_on_disconnect: bool = True, cameras: dict = <factory>, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/hope_jr/config_hope_jr.py#L26)

## RebotB601Follower[[lerobot.robots.rebot_b601_follower.RebotB601Follower]]

#### lerobot.robots.rebot_b601_follower.RebotB601Follower[[lerobot.robots.rebot_b601_follower.RebotB601Follower]]

```python
lerobot.robots.rebot_b601_follower.RebotB601Follower(config: RebotB601FollowerRobotConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/rebot_b601_follower/rebot_b601_follower.py#L62)

Рука-последователь Seeed Studio reBot B601 (6 степеней свободы + захват, CAN-двигатели).

Обмен с моторами осуществляется через пакет `motorbridge` по шине CAN, доступной либо через последовательный мост Damiao, либо через собственный CAN-транспорт MotorBridge.

#### настроить[[lerobot.robots.rebot_b601_follower.RebotB601Follower.configure]]

```python
configure()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/rebot_b601_follower/rebot_b601_follower.py#L224)

Установите режим управления для каждого двигателя перед включением момента.

#### disable_torque[[lerobot.robots.rebot_b601_follower.RebotB601Follower.disable_torque]]

```python
disable_torque()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/rebot_b601_follower/rebot_b601_follower.py#L245)

Отключите момент двигателя, чтобы можно было перемещать руку вручную (отладка только для чтения).

#### отключить[[lerobot.robots.rebot_b601_follower.RebotB601Follower.disconnect]]

```python
disconnect()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/rebot_b601_follower/rebot_b601_follower.py#L444)

Отключите моторы и камеры от робота.

#### send_action[[lerobot.robots.rebot_b601_follower.RebotB601Follower.send_action]]

```python
send_action(action: dict)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/rebot_b601_follower/rebot_b601_follower.py#L313)

Установите манипулятор в целевую конфигурацию суставов.

Позиции выражаются в градусах. Относительная величина действия может быть ограничена в зависимости от `max_relative_target`, поэтому всегда возвращается фактически отправленное действие.

#### lerobot.robots.rebot_b601_follower.RebotB601FollowerRobotConfig[[lerobot.robots.rebot_b601_follower.RebotB601FollowerRobotConfig]]

```python
lerobot.robots.rebot_b601_follower.RebotB601FollowerRobotConfig(port: str, motor_family: MotorFamily = <MotorFamily.DM: 'dm'>, can_adapter: str | None = None, dm_serial_baud: int = 921600, disable_torque_on_disconnect: bool = True, max_relative_target: float | dict[str, float] | None = None, cameras: dict = <factory>, motor_can_ids: dict[str, tuple[int, int]] | None = None, control_mode: ArmControlMode = <ArmControlMode.MIT: 'mit'>, gripper_control_mode: lerobot.robots.rebot_b601_follower.motor_family.GripperControlMode | None = None, mit_kp: float | dict[str, float] | None = None, mit_kd: float | dict[str, float] | None = None, pos_vel_velocity: float | dict[str, float] | None = None, gripper_torque_ratio: float | None = None, gripper_torque_limit: float | None = None, gripper_hold_torque_limit: float | None = None, joint_limits: dict[str, tuple[float, float]] | None = None, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/rebot_b601_follower/config_rebot_b601_follower.py#L119)

Зарегистрированная конфигурация для робота-последователя reBot B601.

## BiRebotB601Follower[[lerobot.robots.bi_rebot_b601_follower.BiRebotB601Follower]]

#### lerobot.robots.bi_rebot_b601_follower.BiRebotB601Follower[[lerobot.robots.bi_rebot_b601_follower.BiRebotB601Follower]]

```python
lerobot.robots.bi_rebot_b601_follower.BiRebotB601Follower(config: BiRebotB601FollowerConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/bi_rebot_b601_follower/bi_rebot_b601_follower.py#L28)

Двуручный последователь Seeed Studio reBot B601.

Составляет два экземпляра `RebotB601Follower` с одним манипулятором. Ключи наблюдений и действий каждого манипулятора именуются с префиксом `left_` / `right_`.

#### lerobot.robots.bi_rebot_b601_follower.BiRebotB601FollowerConfig[[lerobot.robots.bi_rebot_b601_follower.BiRebotB601FollowerConfig]]

```python
lerobot.robots.bi_rebot_b601_follower.BiRebotB601FollowerConfig(left_arm_config: RebotB601FollowerConfig, right_arm_config: RebotB601FollowerConfig, cameras: dict = <factory>, id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/bi_rebot_b601_follower/config_bi_rebot_b601_follower.py#L27)

Класс конфигурации для двуручного робота-последователя reBot B601.

## EarthRoverMiniPlus[[lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlus]]

#### lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlus[[lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlus]]

```python
lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlus(config: EarthRoverMiniPlusConfig)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/earthrover_mini_plus/robot_earthrover_mini_plus.py#L73)

**Параметры:**

config : Конфигурация робота

sdk_base_url : Базовый URL сервера Frodobots SDK, полученный из `config.sdk_url` (по умолчанию: http://localhost:8000)

Робот EarthRover Mini Plus, управляемый через HTTP API Frodobots SDK.

Этот робот использует облачное управление через Frodobots SDK вместо прямого подключения к аппаратному обеспечению. Камеры транслируют видео через WebRTC в облаке Agora, а команды управления отправляются с помощью HTTP POST-запросов.

Робот поддерживает:
- Две камеры (передняя и задняя), доступные через HTTP-эндпоинты SDK
- Управление линейной и угловой скоростью
- Телеметрия батареи и ориентации

#### калибровать[[lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlus.calibrate]]

```python
calibrate()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/earthrover_mini_plus/robot_earthrover_mini_plus.py#L153)

Калибровка не требуется для роботов на базе SDK.

#### настроить[[lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlus.configure]]

```python
configure()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/earthrover_mini_plus/robot_earthrover_mini_plus.py#L166)

Настройка робота (пустая операция для робота на базе SDK).

#### подключить[[lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlus.connect]]

```python
connect(calibrate: bool = True)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/earthrover_mini_plus/robot_earthrover_mini_plus.py#L124)

**Параметры:**

calibrate : Не используется для роботов на базе SDK (сохранено для совместимости с API)

**Исключения:** ``DeviceAlreadyConnectedError`` или ``DeviceNotConnectedError``

- ``DeviceAlreadyConnectedError`` -- если робот уже подключен
- ``DeviceNotConnectedError`` -- если не удалось подключиться к серверу SDK

Подключитесь к роботу через Frodobots SDK.

#### отключить[[lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlus.disconnect]]

```python
disconnect()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/earthrover_mini_plus/robot_earthrover_mini_plus.py#L366)

**Исключения:** ``DeviceNotConnectedError``

- ``DeviceNotConnectedError`` -- если робот не подключен

Отключитесь от робота.

Останавливает робота и закрывает соединение с SDK.

#### get_observation[[lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlus.get_observation]]

```python
get_observation()
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/earthrover_mini_plus/robot_earthrover_mini_plus.py#L248)

**Возвращает:** `RobotObservation`

Наблюдение, содержащее:
- front: изображение с фронтальной камеры (480, 640, 3) в формате RGB
- rear: изображение с задней камеры (480, 640, 3) в формате RGB
- speed: float - Текущая скорость (сырое значение SDK)
- battery_level: float - Уровень заряда батареи (0-100)
- orientation: float - Ориентация робота в градусах
- gps_latitude: float - координата широты по GPS
- gps_longitude: float - координата долготы по GPS
- gps_signal: float - сила сигнала GPS (в процентах)
- signal_level: float - Уровень сигнала сети (0-5)
- vibration: float - Показание датчика вибрации
- lamp: float - Состояние лампы (0=выкл, 1=вкл)
- accelerometer_x/y/z: float - Оси акселерометра (сырое значение SDK)
- gyroscope_x/y/z: float - Оси гироскопа (сырое значение SDK)
- magnetometer_filtered_x/y/z: float - Оси магнитометра (сырое значение SDK)
- wheel_rpm_0/1/2/3: float - Обороты колес

**Исключения:** ``DeviceNotConnectedError``

- ``DeviceNotConnectedError`` -- если робот не подключен

Получить текущее наблюдение робота из SDK.

Кадровые данные камеры извлекаются из эндпоинтов SDK /v2/front и /v2/rear. Кадры декодируются из base64 и конвертируются из формата BGR в RGB. Телеметрия робота извлекается из эндпоинта /data. Массивы датчиков (accels, gyros, mags, rpms) содержат записи вида [values..., timestamp]; для каждого массива используется последнее значение.

Note: Кадровые данные камеры получаются из эндпоинтов SDK /v2/front и /v2/rear. Кадры декодируются из base64 и конвертируются из формата BGR в RGB. Телеметрия робота получается из эндпоинта /data. Все значения SDK нормализуются до соответствующих диапазонов для записи в датасет.

#### send_action[[lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlus.send_action]]

```python
send_action(action: dict)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/earthrover_mini_plus/robot_earthrover_mini_plus.py#L334)

**Параметры:**

action : Словарь действий с ключами: - linear_velocity: Целевая линейная скорость (от -1 до 1) - angular_velocity: Целевая угловая скорость (от -1 до 1)

**Возвращает:** `RobotAction`

Действие, которое было отправлено (совпадает с ключами action_features)

**Исключения:** ``DeviceNotConnectedError``

- ``DeviceNotConnectedError`` -- если робот не подключен

Отправьте действие роботу через SDK.

Note: Действия отправляются в SDK через эндпоинт POST /control. SDK ожидает команды в диапазоне [-1, 1].

#### lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlusConfig[[lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlusConfig]]

```python
lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlusConfig(sdk_url: str = 'http://localhost:8000', id: str | None = None, calibration_dir: pathlib.Path | None = None)
```

[Источник](https://github.com/huggingface/lerobot/blob/v0.7.0/src/lerobot/robots/earthrover_mini_plus/config_earthrover_mini_plus.py#L25)

**Параметры:**

sdk_url : URL сервера Frodobots SDK (по умолчанию: http://localhost:8000)

Конфигурация для робота EarthRover Mini Plus с использованием Frodobots SDK.

Этот робот использует облачное управление через HTTP API Frodobots SDK. Кадры с камеры доступны напрямую через HTTP-эндпоинты SDK.

