본문으로 이동
원문 확인

마이크로덕 시뮬레이터 | 공개 동작 불러오기와 원래 동작 복원

실물 없이 브라우저에서 걷기를 시험하고 공개 정책을 URL로 불러옵니다. PLAYING 표시, manifest 슬롯과 61개 입력 조건, 오류 및 해제 후 기본 동작 복원까지 안내합니다.

공식 시뮬레이터에서 Waddle In으로 시작해 방향키로 기본 걷기를 확인하세요. 공개 정책은 ?move=소유자/저장소 링크로 불러옵니다. PLAYING은 불러온 상태이지 현재 구동 중이라는 뜻이 아니며, ✕를 누르면 해당 슬롯의 공식 동작이 돌아옵니다. 10월 12일 공식 sprint 참고 모델의 불러오기와 해제를 확인했습니다.

기체 없이 먼저 해 볼 한 가지 과제

  1. 공식 시뮬레이터 로딩 후 Waddle In 또는 Enter로 들어갑니다.
  2. 필요하면 장면을 클릭하고 ↑를 잠깐 눌러 전진합니다.
  3. 놓은 뒤 ← / →로 회전합니다.
  4. Space로 초기화한 다음 동작 체험을 계속할지 훈련을 배울지 선택합니다.

진입·전진·회전·초기화를 확인하면 완료입니다. 기존 정책을 사용합니다.

공식 시뮬레이터 열기 ↗

먼저 기본 걷기를 확인하세요

공식 브라우저 시뮬레이터에서 장면과 정책 파일 로딩을 기다리고 Waddle In을 누릅니다. 입력이 안 되면 장면을 클릭하세요. Feet 모드에서 ↑를 잠깐 길게 눌러 앞으로 이동하고, 손을 뗀 뒤 ←/→로 회전합니다. Space는 초기화입니다. 이 사이트의 입장·전진·초기화 데스크톱 확인은 9월 8일에 이뤄졌습니다.

키는 실행 환경에 맞춰 보세요

  • ↑/↓ 또는 W/S: 앞뒤 이동. ←/→ 또는 A/D: 좌우 회전이며 옆걸음은 아닙니다.
  • 기본 R: Feet에서는 앉기/서기. episodic 기술·script·sitstand를 불러오면 Feet에서 R이 해당 동작을 실행합니다. Rollers에서는 다른 동작이 로드돼 있어도 R이 먼저 웅크려 미끄러지기를 실행합니다.
  • Q/E는 좌우 킥, F는 번갈아 킥, G는 바닥 물체 집기 동작이며 Feet에서 사용합니다.
  • M은 Feet/Rollers 전환이고 첫 Rollers 전환에는 추가 파일 로딩이 있을 수 있습니다. C는 추적 카메라, Space는 초기화입니다.

공식 키보드 코드는 물리적인 키 위치를 사용합니다. 한글 키보드에서 문자키가 헷갈리면 방향키부터 시험하세요. 별도 로컬 Python 뷰어의 단축키를 브라우저에 적용하면 안 됩니다.

공개 참고 모델을 링크로 불러오기

공식 sprint 참고 모델 링크를 열면 ?move= 매개변수로 공개 Hugging Face 저장소가 지정됩니다. Waddle In 후 LOADING MOVE를 거쳐 PLAYING과 모델명이 보입니다. PLAYING은 로드 상태일 뿐 현재 구동 중이라는 뜻은 아닙니다. perpetual/walk는 Feet 보행에서 구동하고, episodic·script·sitstand는 Feet에서 R로 실행합니다. Rollers에서는 R이 먼저 웅크려 미끄러지기를 실행합니다. 10월 12일 익명 브라우저에서 “SPRINT-2M-REFERENCE BY POLLEN-ROBOTICS” 표시와 ✕를 통한 해제를 확인했습니다. 속도나 보행 품질은 측정하지 않았습니다. 고정 버전 manifest에는 MicroDuck perpetual/walk, 관측 61개와 동작 14개가 기록돼 있습니다.

다른 공개 단일 정책 저장소를 시험하려면 ?move= 값을 owner/repo로 바꿉니다. 시작 코드에는 ?policy= 별칭도 있습니다. 브라우저가 접근할 수 있는 HTTPS .onnx 직접 링크도 가능하며 같은 폴더의 manifest.json을 찾아봅니다. 접근 권한이나 CORS 때문에 실패할 수 있습니다. 검토한 화면에는 로컬 파일 업로드 버튼이 없습니다. 비공개 Academy session은 로그인해야 하는 별도 경로입니다.로더 구현.

manifest와 입력 길이가 맞아야 합니다

검토한 로더는 model_api 2 이하를 지원합니다. perpetual은 기본적으로 walk 슬롯을 바꾸고 sitstand를 지정하면 R의 앉기/서기 동작을 바꿉니다. episodic은 R로 한 번 실행하는 기술입니다. script는 기본 걷기 위에 13차원 명령 시간표를 올리는 방식이며 ONNX 정책은 아닙니다. policies 배열로 묶인 여러 정책은 거부하고, manifest가 없으면 단일 걷기 정책으로 취급합니다.

ONNX 정책은 관측 61개 입력과 관절 동작 14개 출력을 가져야 합니다. 로드 과정에서 입력·출력 하나씩인지, 출력이 유한하고 일정한 값만 내지 않는지 검사합니다. 하지만 관측값의 뜻, 부착 장치, 동작 스케일이 같은지는 이 검사가 보장하지 않습니다. Rollers용 모델을 숫자 모양만 보고 Feet 걷기에 쓰거나 실물 호환을 판단하지 마세요.

해제와 오류 복구

PLAYING 옆 ✕를 누르면 로드된 동작을 명시적으로 해제하고, 해당 슬롯의 공식 동작으로 복원됩니다. 화면 코드와 슬롯 복원 코드에 구현돼 있고, 이번 공개 참고 모델에서 버튼 해제를 확인했습니다. 다른 모델을 시험하기 전에 ✕로 먼저 해제하세요. 새 공개 링크에서 처음 불러오기에 실패하면 오류가 표시되고 기본 정책은 남아 있습니다. 이미 다른 사용자 동작이 로드된 상태에서 두 번째 불러오기에 실패할 경우 기존 동작이 자동으로 해제되지는 않습니다. 미리 ✕로 해제하거나 매개변수가 없는 시뮬레이터 URL로 다시 시작하세요. 실행 중 숫자 이상이나 짧은 시간에 여러 번 비정상적으로 넘어지는 경우에도 소스상 자동으로 되돌립니다. 이는 브라우저 로직이며 실물 안전성 검증은 아닙니다.

키가 듣지 않으면 안내 화면을 닫고 장면을 클릭한 뒤 방향키를 시험하세요. 내장 화면에서 포커스 문제가 있으면 직접 페이지를 사용합니다. 처음 로딩이 멈추면 ?boot=1 진단 화면에서 마지막 성공 단계와 오류를 기록하세요.공식 README. 브라우저에서 정책을 바꾸는 일은 학습이나 로봇 설치가 아닙니다. 학습은 환경 안내, 실물 관리는 정책 안내를 따르세요.

**버전 기준:**공개 동작의 URL 불러오기는 9월에 구현된 기능을 이번에 보완해 확인한 것입니다. Space의 최신 10월 9일 커밋은 라이선스 추가뿐입니다.9월 최초 변경 · manifest 처리 · 10월 최신 커밋.

계속하기 전에 확인

정책을 로드하면 새 정책이 학습되나요?

아니요. 시뮬레이터에서 기존 정책을 실행하는 것과 학습은 다른 작업입니다.

적용 범위: Pollen Robotics MicroDuck. 모델, 이미지, 소프트웨어, 드라이버 버전을 함께 기록하세요. 날짜별 설명은 원래 검증 범위를 유지합니다.

출처 확인일:

출처와 검토 (15)
  1. huggingface.co/spaces/pollen-robotics/microduck-simulator
  2. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/README.md
  3. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/app/src/App.jsx
  4. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/app/src/game/custom-policy.js
  5. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/app/src/game/game.js
  6. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/app/src/ui/Hud.jsx
  7. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/app/src/game/controls/keyboard.js
  8. huggingface.co/pollen-robotics/microduck-sprint-2m-reference/blob/62afcc461f1d4a5ac22bfbff55ce4900c1afba32/manifest.json
  9. huggingface.co/spaces/pollen-robotics/microduck-simulator/commit/cb0312619f09138069130328c3bef05736e1730c
  10. huggingface.co/spaces/pollen-robotics/microduck-simulator/commit/850e9430c7d4451ca35a69f8600cca74ce51814f
  11. huggingface.co/spaces/pollen-robotics/microduck-simulator/commit/ad9d41a763f30dc770817c33d92dcfec0205db1e
  12. github.com/pollen-robotics/microduck_rl/blob/ceca01706143d729305baa94cbd8ab990979e325/scripts/infer_policy.py
  13. pollen-robotics-microduck-simulator.hf.space/?move=pollen-robotics%2Fmicroduck-sprint-2m-reference
  14. pollen-robotics-microduck-simulator.hf.space/
  15. pollen-robotics-microduck-simulator.hf.space/?boot=1

다음에 읽을 가이드

MicroDuck 학습부터 배포까지: 준비·학습·내보내기·검증

준비, 로컬 학습, 내보내기, 시뮬레이션 재생, 배포 점검 순으로 읽으세요. 내보내기나 업로드 성공은 실물 정책 실행의 증거가 아닙니다.

MicroDuck 첫 학습 실행 | CUDA 확인·짧은 시험·클라우드 미리보기

소스를 고정하고 Python 3.12 환경에서 CUDA와 태스크를 확인합니다. 64개 환경·5회 반복으로 설치를 점검한 뒤 체크포인트를 보관하고 클라우드 작업 사양을 미리 봅니다.

MicroDuck 문제 해결: 업데이트, 페어링, 정책

MicroDuck 0.20.1: 복구 전에 접속 경로 확인. Wi-Fi SSH는 기기에서 직접 결정합니다. daemon/API와 Setup Code를 확인하고 접속 거부와 업데이트 실패를 구분하세요.