Reachy Mini SDK — 플랫폼 선택과 제어 시작 안내

번역 범위와 문서 버전

공식 SDK 저장소의 2026년 10월 2일 커밋을 기준으로 README의 Build and start your own robot, Getting Started with Reachy Mini SDK 중 User guides와 Quick Look, Hardware Overview를 한국어로 옮겼습니다. 아래의 자료 활용 안내는 편집자가 덧붙였습니다. 로봇 최초 출시일이 아니라 확인한 소프트웨어 문서 버전 날짜이며, 전체 README나 전체 하드웨어 조립 설명서의 전문 번역은 아닙니다.

플랫폼 선택

사용하는 플랫폼에 맞는 안내를 선택합니다. Reachy Mini 무선형은 Raspberry Pi CM4, 배터리와 Wi-Fi를 갖춘 자체 실행형입니다. Reachy Mini Lite는 USB로 컴퓨터와 연결하는 개발자용 버전입니다. 시뮬레이션은 실물 하드웨어 없이 MuJoCo에서 시제품 동작을 개발하는 경로입니다. 공식 경로는 각각 https://huggingface.co/docs/reachy_mini/platforms/reachy_mini/get_started , https://huggingface.co/docs/reachy_mini/platforms/reachy_mini_lite/get_started , https://huggingface.co/docs/reachy_mini/platforms/simulation/get_started 입니다.

앱 설치 도구

원문은 uv를 설치하면 앱 설치가 10~100배 빨라진다고 안내합니다. 이는 원문이 제시한 설명이며 로봇노드가 측정한 결과가 아닙니다. uv는 자동 감지되며 없으면 pip로 대체됩니다. 설치 안내: https://docs.astral.sh/uv/getting-started/installation/

SDK 사용자 문서

Installation은 컴퓨터 설정, Quickstart Guide는 첫 동작 실행, JavaScript SDK & Web Apps는 WebRTC로 로봇을 제어하는 브라우저 앱을 다룹니다. AI Integrations는 언어 모델 연결·앱 제작·Hugging Face 게시를 설명합니다. Core Concepts에는 구조·좌표계·안전 제한이, Python SDK에는 스크립트·제어 루프·로봇 내부 실행 코드가 있습니다. 공식 시작점: https://huggingface.co/docs/reachy_mini/SDK/installation 나머지 공식 경로: https://huggingface.co/docs/reachy_mini/SDK/quickstart , https://huggingface.co/docs/reachy_mini/SDK/javascript-sdk , https://huggingface.co/docs/reachy_mini/SDK/integration , https://huggingface.co/docs/reachy_mini/SDK/core-concept , https://huggingface.co/docs/reachy_mini/SDK/python-sdk .

예제와 학습 경로

README는 커뮤니티 앱 공유 안내, examples 폴더와 docs/notebooks를 함께 연결합니다. 노트북은 연결·움직임·카메라·오디오를 단계별로 다룹니다. 앱 공유 안내: https://huggingface.co/blog/pollen-robotics/make-and-publish-your-reachy-mini-apps . 예제: https://github.com/pollen-robotics/reachy_mini/tree/a4ee426724c2cc6411c238094d129d47fa8ad836/examples 노트북: https://github.com/pollen-robotics/reachy_mini/tree/a4ee426724c2cc6411c238094d129d47fa8ad836/docs/notebooks

빠른 시작: 브라우저와 Python

원문은 새 앱에 웹·JavaScript 경로를 권장합니다. 브라우저의 정적 페이지가 WebRTC로 로봇을 제어하며 앱 사용자는 별도 앱 설치 없이 사용할 수 있다고 설명합니다. 로봇 내부 제어 루프를 Python으로 작성하려면 SDK 설치 후 로봇을 깨어 있는 상태로 두고 ReachyMini 컨텍스트를 사용합니다. 원문의 짧은 예제는 머리를 위로 움직이고 기울이는 동작입니다.

Python 예제

from reachy_mini import ReachyMini from reachy_mini.utils import create_head_pose with ReachyMini() as mini: # 위를 보고 머리를 기울입니다. mini.goto_target( head=create_head_pose(z=10, roll=15, degrees=True, mm=True), duration=1.0 ) 실행 가능한 형식의 같은 코드를 guide-ko.md에도 넣었습니다. 로봇노드에서 실제 하드웨어 실행 시험을 수행한 예제는 아닙니다.

하드웨어 개요

로봇은 키트로 판매되며 원문은 일반적인 조립 시간을 2~3시간으로 안내합니다. 자세한 조립 단계는 플랫폼별 안내를 사용합니다. 무선형은 Raspberry Pi CM4에서 자체 실행하고 IMU를 포함합니다. Lite는 사용자 PC에서 실행하며 벽면 전원에 연결합니다. 제품 변형에 따라 해당 하드웨어 문서를 확인해야 합니다.

자료 활용과 이용 조건

첨부 README와 LICENSE는 해당 커밋의 원본이며 수정하지 않았습니다. 한국어 번역·선택 편집은 로봇노드가 작성한 변경본으로 Apache-2.0을 적용합니다. Copyright 2025 Pollen Robotics. README는 하드웨어 설계 파일을 별도의 Creative Commons BY-SA-NC 조건으로 구분합니다. 이번 묶음은 소프트웨어 문서만 포함하며 하드웨어 설계·그림·동영상 파일은 포함하지 않습니다.

목록보기