# 로봇

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/main/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/main/src/lerobot/robots/robot.py#L136)

**매개변수:**

calibrate (bool) : True인 경우, 로봇이 연결된 후 보정이 되어 있지 않거나 보정이 필요한 경우 자동으로 보정합니다(하드웨어에 따라 다름).

로봇과 통신을 설정합니다.

#### 연결 해제[[lerobot.robots.Robot.disconnect]]

```python
disconnect()
```

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/robot.py#L237)

로봇에서 연결을 해제하고 필요한 정리 작업을 수행합니다.

#### 구성[[lerobot.robots.Robot.configure]]

```python
configure()
```

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/robot.py#L202)

로봇에 일회성 또는 런타임 구성을 적용합니다. 여기에는 모터 매개변수, 제어 모드 또는 초기 상태 설정이 포함될 수 있습니다.

#### 교정[[lerobot.robots.Robot.calibrate]]

```python
calibrate()
```

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/robot.py#L153)

적용 가능한 경우 로봇을 보정합니다. 그렇지 않으면 이 작업은 아무 효과도 없습니다(no-op).

이 메서드는 필요한 데이터(예: 모터 오프셋)를 수집하고 `calibration` 사전에 따라 적절히 업데이트해야 합니다.

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

```python
get_observation()
```

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/robot.py#L210)

**반환값:** `RobotObservation`

로봇의 현재 감각 상태를 나타내는 평탄한 사전입니다. 구조는 `observation_features`와 일치해야 합니다.

로봇에서 현재 관측값을 가져옵니다.

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

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

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/robot.py#L222)

**매개변수:**

action (RobotAction) : 원하는 행동을 나타내는 사전. 구조는 `action_features`와 일치해야 합니다.

**반환값:** `RobotAction`

모터에 실제로 전송되는 액션은 속도 안전 한계와 같은 요인에 의해 잘리거나 수정될 수 있습니다.

로봇에 액션 명령을 전송합니다.

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

```python
observation_features()
```

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/robot.py#L100)

로봇이 생성하는 관측치의 구조와 유형을 설명하는 사전입니다. 이 사전의 구조(키)는 `get_observation`가 반환하는 값의 구조와 일치해야 합니다. 사전의 값은 다음 중 하나여야 합니다:
- 단순 값인 경우의 값 유형, 예: 단일 고유감각 값(관절의 위치/속도)의 경우 `float`
- 배열 타입의 값인 경우, 예를 들어 이미지의 경우 `(height, width, channel)`와 같이 형태를 나타내는 튜플

참고: 이 속성은 로봇이 연결되어 있든 아니든 상관없이 호출할 수 있어야 합니다.

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

```python
action_features()
```

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/robot.py#L114)

로봇이 기대하는 액션의 구조와 유형을 설명하는 사전입니다. 구조(키)는 `send_action`에 전달되는 값의 구조와 일치해야 합니다. 사전의 값은 단순한 값인 경우 해당 값의 유형이어야 하며, 예를 들어 단일 고유감각 값(관절의 목표 위치/속도)의 경우 `float`입니다.

참고: 이 속성은 로봇이 연결되어 있든 아니든 상관없이 호출할 수 있어야 합니다.

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

```python
is_connected()
```

[소스](https://github.com/huggingface/lerobot/blob/main/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/main/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/main/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/main/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/main/src/lerobot/robots/so_follower/so_follower.py#L54)

SO-100/101/10X의 공통 기능을 구현하는 범용 SO 팔로워 베이스입니다. 하드웨어 모델별 `config_class`와 `name`을 사용하여 하위 클래스로 구현하도록 설계되었습니다.

#### 연결[[lerobot.robots.so_follower.SOFollower.connect]]

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

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/so_follower/so_follower.py#L110)

연결 시점에 arm이 정지 상태에 있으며, 보정을 실행하기 위해 토크를 안전하게 비활성화할 수 있다고 가정합니다.

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

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

[소스](https://github.com/huggingface/lerobot/blob/main/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/main/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/main/src/lerobot/robots/bi_so_follower/bi_so_follower.py#L31)

TheRobotStudio가 설계한 [양손 SO 팔로우 암](https://github.com/TheRobotStudio/SO-ARM100)

#### 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/main/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/main/src/lerobot/robots/koch_follower/koch_follower.py#L33)

- Alexander Koch가 [Tau Robotics](https://tau-robotics.com)에서 개발한 [Koch v1.0](https://github.com/AlexanderKoch-Koch/low_cost_robot) (손목-팔꿈치 확장 포함 및 미포함)
- Jess Moss가 개발한 [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/main/src/lerobot/robots/koch_follower/koch_follower.py#L89)

연결 시점에 arm이 정지 상태에 있으며, 보정을 실행하기 위해 토크를 안전하게 비활성화할 수 있다고 가정합니다.

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

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

[소스](https://github.com/huggingface/lerobot/blob/main/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/main/src/lerobot/robots/koch_follower/config_koch_follower.py#L24)

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

`LeKiwi`는 로봇 자체에서 실행됩니다. `LeKiwiClient`는 네트워크를 통해 `LeKiwi`와 통신하는 호스트 측 프록시이며, 동일한 `Robot` 인터페이스를 제공합니다.

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

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

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/lekiwi/lekiwi.py#L36)

로봇에는 3개의 옴니휠로 구성된 이동 기반과 원격 팔로워 암이 포함되어 있습니다. 리더 암은 로컬(노트북)에 연결되어 있으며, 그 관절 위치가 기록된 후 안전 클램프가 적용되어 원격 팔로워 암으로 전달됩니다. 이와 동시에, 키보드 텔레오퍼레이션을 사용하여 바퀴의 원시 속도 명령을 생성합니다.

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

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

[소스](https://github.com/huggingface/lerobot/blob/main/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/main/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/main/src/lerobot/robots/lekiwi/lekiwi_client.py#L40)

#### 연결[[lerobot.robots.lekiwi.LeKiwiClient.connect]]

```python
connect()
```

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/lekiwi/lekiwi_client.py#L129)

원격 모바일 로봇과 ZMQ 소켓을 설정합니다

#### 연결 해제[[lerobot.robots.lekiwi.LeKiwiClient.disconnect]]

```python
disconnect()
```

[소스](https://github.com/huggingface/lerobot/blob/main/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/main/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/main/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/main/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/main/src/lerobot/robots/openarm_follower/openarm_follower.py#L40)

CAN 버스 통신을 사용하여 그리퍼가 장착된 7 DOF 팔을 제어하는 OpenArms Follower Robot입니다. 이 팔은 MIT 제어 모드로 동작하는 Damiao 모터를 사용합니다.

#### 교정[[lerobot.robots.openarm_follower.OpenArmFollower.calibrate]]

```python
calibrate()
```

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/openarm_follower/openarm_follower.py#L162)

OpenArms 로봇에 대해 보정 절차를 실행합니다.

교정 절차:
1. 토크 비활성화
2. 그리퍼가 닫힌 상태로 팔을 매달린 자세로 위치하도록 사용자에게 요청합니다
3. Set this as zero position
4. 각 관절의 운동 범위를 기록
5. 교정 저장

#### 구성[[lerobot.robots.openarm_follower.OpenArmFollower.configure]]

```python
configure()
```

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/openarm_follower/openarm_follower.py#L213)

적절한 설정으로 모터를 구성합니다.

#### 연결[[lerobot.robots.openarm_follower.OpenArmFollower.connect]]

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

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/openarm_follower/openarm_follower.py#L130)

로봇에 연결하고 필요에 따라 보정합니다.

연결 시점에 팔이 안전한 휴지 위치에 있으며, 필요할 경우 토크를 안전하게 비활성화하여 보정을 실행할 수 있다고 가정합니다.

#### 연결 해제[[lerobot.robots.openarm_follower.OpenArmFollower.disconnect]]

```python
disconnect()
```

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/openarm_follower/openarm_follower.py#L343)

로봇에서 연결을 해제합니다.

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

```python
get_observation()
```

[소스](https://github.com/huggingface/lerobot/blob/main/src/lerobot/robots/openarm_follower/openarm_follower.py#L224)

로봇에서 위치, 속도, 토크를 포함한 현재 관측값을 가져옵니다.

3개의 개별 읽기 대신 하나의 CAN 리프레시 사이클에서 모든 모터 상태(pos/vel/torque)를 읽습니다.

#### 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/main/src/lerobot/robots/openarm_follower/openarm_follower.py#L264)

**매개변수:**

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/main/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/main/src/lerobot/robots/bi_openarm_follower/bi_openarm_follower.py#L31)

양수 OpenArm 팔로워 암

#### 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/main/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/main/src/lerobot/robots/omx_follower/omx_follower.py#L33)

- [OMX](https://github.com/ROBOTIS-GIT/open_manipulator), 확장, [ROBOTIS](https://ai.robotis.com/)의 Woojin Wie와 Junha Cha가 개발

#### 연결[[lerobot.robots.omx_follower.OmxFollower.connect]]

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

[소스](https://github.com/huggingface/lerobot/blob/main/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/main/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/main/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/main/src/lerobot/robots/reachy2/robot_reachy2.py#L75)

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

#### 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/main/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/main/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, ease_in_s: float = 2.0, 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/main/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/main/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/main/src/lerobot/robots/hope_jr/hope_jr_arm.py#L88)

연결 시점에 arm이 정지 상태에 있으며, 보정을 실행하기 위해 토크를 안전하게 비활성화할 수 있다고 가정합니다.

#### 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/main/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/main/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/main/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/main/src/lerobot/robots/rebot_b601_follower/rebot_b601_follower.py#L62)

Seeed Studio reBot B601 팔로우 암 (6-DOF + 그리퍼, CAN 모터).

모터 통신은 `motorbridge` 패키지를 통해 CAN 버스로 처리되며, Damiao 시리얼 브리지 또는 MotorBridge의 네이티브 CAN 전송을 통해 접근할 수 있습니다.

#### 구성[[lerobot.robots.rebot_b601_follower.RebotB601Follower.configure]]

```python
configure()
```

[소스](https://github.com/huggingface/lerobot/blob/main/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/main/src/lerobot/robots/rebot_b601_follower/rebot_b601_follower.py#L245)

motor torque를 비활성화하여 팔을 수동으로 이동할 수 있도록 합니다(읽기 전용 디버깅).

#### 연결 해제[[lerobot.robots.rebot_b601_follower.RebotB601Follower.disconnect]]

```python
disconnect()
```

[소스](https://github.com/huggingface/lerobot/blob/main/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/main/src/lerobot/robots/rebot_b601_follower/rebot_b601_follower.py#L313)

팔을 목표 관절 구성으로 명령합니다.

Positions는 도(degree) 단위로 표현됩니다. `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/main/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/main/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/main/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/main/src/lerobot/robots/earthrover_mini_plus/robot_earthrover_mini_plus.py#L73)

**매개변수:**

config : 로봇 구성

sdk_base_url : Frodobots SDK 서버의 기본 URL, `config.sdk_url`에서 가져온 값 (기본값: http://localhost:8000)

Frodobots SDK HTTP API를 통해 제어되는 EarthRover Mini Plus 로봇.

이 로봇은 하드웨어를 직접 연결하는 대신 Frodobots SDK를 통해 클라우드 기반 제어를 사용합니다. 카메라는 Agora 클라우드를 통해 WebRTC로 스트리밍되며, 제어 명령은 HTTP POST 요청을 통해 전송됩니다.

로봇은 다음을 지원합니다:
- SDK HTTP 엔드포인트를 통해 액세스하는 듀얼 카메라(전면 및 후면)
- 선형 및 각속도 제어
- 배터리 및 방향 텔레메트리

#### 교정[[lerobot.robots.earthrover_mini_plus.EarthRoverMiniPlus.calibrate]]

```python
calibrate()
```

[소스](https://github.com/huggingface/lerobot/blob/main/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/main/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/main/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/main/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/main/src/lerobot/robots/earthrover_mini_plus/robot_earthrover_mini_plus.py#L248)

**반환값:** `RobotObservation`

다음 내용을 포함하는 관찰:
- front: RGB 형식의 전면 카메라 이미지 (480, 640, 3)
- rear: RGB 형식의 후면 카메라 이미지 (480, 640, 3)
- speed: float - 현재 속도 (원시 SDK 값)
- battery_level: float - 배터리 수준 (0-100)
- orientation: float - 도 단위(robot orientation)
- 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 - 바퀴 RPM

**예외:** ``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/main/src/lerobot/robots/earthrover_mini_plus/robot_earthrover_mini_plus.py#L334)

**매개변수:**

action : 다음 키를 가진 Action 딕셔너리: - linear_velocity: 목표 선형 속도 (-1에서 1) - angular_velocity: 목표 각속도 (-1에서 1)

**반환값:** `RobotAction`

보낸 액션( 키와 일치)

**예외:** ``DeviceNotConnectedError``

- ``DeviceNotConnectedError`` -- 로봇이 연결되지 않은 경우

SDK를 통해 로봇에 액션을 전송합니다.

Note: Actions are sent to SDK via POST /control endpoint. SDK expects commands in range [-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/main/src/lerobot/robots/earthrover_mini_plus/config_earthrover_mini_plus.py#L25)

**매개변수:**

sdk_url : Frodobots SDK 서버의 URL (기본값: http://localhost:8000)

Frodobots SDK를 사용하여 EarthRover Mini Plus 로봇을 구성하는 설정입니다.

이 로봇은 Frodobots SDK HTTP API를 통해 클라우드 기반 제어를 사용합니다. 카메라 프레임은 SDK HTTP 엔드포인트를 통해 직접 접근합니다.

