시간에 따른 멀티모달 로보틱스 및 센서 데이터를 로깅하고 시각화·조회·스트리밍하는 오픈소스 Rust 툴킷입니다.
pollen-robotics/microduck
소형 이족 보행 오리 로봇을 구동하는 오픈소스 Rust 소프트웨어로, 모션 제어, 게임패드, 업데이트, 카메라 스트리밍을 지원합니다.
- 스타
- 9,611
- 포크
- 1,248
- 열린 이슈
- 43
- 마지막 커밋
- 6시간 전
어떤 프로젝트인가요?
Microduck은 높이 약 25cm, 무게 800g인 소형 이족 보행 오리 로봇을 위한 소프트웨어 스택입니다. Rockchip RK3566에서 실행되며 여러 데몬으로 구성됩니다. robotd는 신경망 정책을 바탕으로 서보 15개를 구동하는 50Hz 제어 루프를 실행하고, 나머지 데몬은 Wi-Fi와 기기 식별, Bluetooth, 게임패드 입력, WebRTC 카메라 스트리밍, 깊이 센서를 처리합니다.
로봇의 보행 정책은 별도의 저장소인 microduck_rl에서 MuJoCo와 PPO를 사용해 학습하며, ONNX 모델로 내보내 이 저장소에서 불러옵니다. 업데이트에는 서명이 적용되고 상태 점검을 거치며, 로봇 상태가 비정상적이면 롤백할 수 있습니다. 데몬은 Unix 소켓을 통해 하나의 JSON-RPC 계약으로 통신하므로 앱, 콘솔, 게임패드, 스크립트가 모두 같은 호출을 사용합니다.
MuJoCo 기반 시뮬레이터를 사용하면 하드웨어 없이 시뮬레이션된 몸체에서 실제 데몬을 실행할 수 있습니다. 로봇의 명령줄 도구를 설명하는 치트 시트도 제공됩니다.
핵심 기능
- 01신경망 정책을 바탕으로 서보 15개를 구동하는 50Hz 제어 루프를 실행합니다.
- 02microduck_rl 학습 프로젝트에서 내보낸 ONNX 정책을 불러옵니다.
- 03게임패드 제어와 노트북을 통한 Bluetooth 접속을 지원합니다.
- 04WebRTC로 카메라 영상을 스트리밍하고 깊이 센서 데이터를 읽습니다.
- 05서명 및 상태 점검을 거치는 소프트웨어 업데이트와 롤백을 지원합니다.
활용 사례
- Microduck 이족 보행 로봇의 제어 소프트웨어를 개발하거나 맞춤화합니다.
- 소형 다족 로봇에서 시뮬레이션-실제 환경 간 강화학습 보행을 실험합니다.
- 하드웨어에서 실행하기 전에 MuJoCo 시뮬레이터에서 로봇 코드를 테스트합니다.
빠른 시작
- 1
시뮬레이션 가이드 읽기
- 2
하드웨어 없이 시뮬레이션된 오리 실행하기
scripts/duck-sim
사용 전 알아둘 점
- Rockchip RK3566과 서보 15개를 탑재한 특정 로봇에서 실행되므로, 대부분의 기능을 사용하려면 실제 오리가 필요합니다.
- 불러오는 정책은 별도의 저장소인 microduck_rl에서 학습됩니다.
토픽
자주 묻는 질문
- microduck은(는) 무엇인가요?
- 소형 이족 보행 오리 로봇을 구동하는 오픈소스 Rust 소프트웨어로, 모션 제어, 게임패드, 업데이트, 카메라 스트리밍을 지원합니다. Microduck은 높이 약 25cm, 무게 800g인 소형 이족 보행 오리 로봇을 위한 소프트웨어 스택입니다. Rockchip RK3566에서 실행되며 여러 데몬으로 구성됩니다. robotd는 신경망 정책을 바탕으로 서보 15개를 구동하는 50Hz 제어 루프를 실행하고, 나머지 데몬은 Wi-Fi와 기기 식별, Bluetooth, 게임패드 입력, WebRTC 카메라 스트리밍, 깊이 센서를 처리합니다.
- microduck은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- microduck은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- microduck은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. microduck의 마지막 커밋은 2026년 10월 19일입니다.
- microduck은(는) 어디에 사용할 수 있나요?
- Microduck 이족 보행 로봇의 제어 소프트웨어를 개발하거나 맞춤화합니다. 소형 다족 로봇에서 시뮬레이션-실제 환경 간 강화학습 보행을 실험합니다. 하드웨어에서 실행하기 전에 MuJoCo 시뮬레이터에서 로봇 코드를 테스트합니다.
- microduck는 어떻게 설치하나요?
- 시뮬레이션 가이드 읽기 하드웨어 없이 시뮬레이션된 오리 실행하기: scripts/duck-sim
- microduck은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pollen-robotics/microduck
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
LLM 플래너, VLA 조작 모델, 메모리를 활용해 시뮬레이터와 실제 로봇에서 작업을 수행하는 임바디드 에이전트 개발 프레임워크입니다.
ASPIRE는 모델 가중치를 학습하는 대신 코딩 에이전트가 재사용 가능한 로봇 스킬을 반복적으로 개선하는 프레임워크입니다.
온라인 멀티플레이, 재접속, 스마트 봇을 지원하며 카드 조작 알고리즘 없이 완전히 무작위로 패를 나누는 Go 기반 Fight the Landlord 게임입니다.
tmux 같은 도구로 탭과 분할 화면을 관리하는 크로스 플랫폼 GPU 가속 OpenGL 터미널 에뮬레이터입니다.