본문으로 이동
원문 확인

MicroDuck ONNX 변환·재생 | 정규화와 61 입력 확인

훈련 체크포인트를 공식 내보내기로 변환하고 관측 정규화를 유지합니다. 현재 입력 레이아웃으로 재생한 뒤 모델 패키지를 미리 검사하고, 이전 정책과 실물 배포의 차이를 확인하세요.

체크포인트 확장자를 바꾸는 대신 해당 태스크의 공식 내보내기를 사용하세요. 관측 정규화까지 포함해 현재 관측 61개·행동 14개의 의미와 순서를 맞춰야 올바른 재생을 확인할 수 있습니다.

먼저 모델이 나온 실험 찾기

커밋, 태스크 ID, 설정과 실제 체크포인트 경로를 보관합니다. 아래 예시 경로를 실제 파일로 바꾸고 기존 first-walk.onnx는 따로 보관하세요.

공식 내보내기 실행

복사 가능한 예제
uv run scripts/export.py Mjlab-Velocity-Flat-MicroDuck \
  --checkpoint-file /absolute/path/to/model_3000.pt \
  --num-envs 1 \
  --onnx-file first-walk.onnx

공식 처리는 학습한 관측 정규화기를 함께 내보냅니다. 임의 변환 모델이 play에서 움직인다는 사실만으로 정규화가 포함됐다고 확인할 수 없습니다.

현재 명령 레이아웃으로 재생

복사 가능한 예제
uv run scripts/infer_policy.py \
  --walking first-walk.onnx \
  --new-cmd-obs

--new-cmd-obs는 현재 61 입력용입니다. 이전 51 입력 모델은 이 옵션을 끄고 원래 구성을 확인해야 합니다. CPU ONNX 추론에도 Python 의존성, 모델 자산과 뷰어 환경이 필요합니다.

조작과 모델 파일 함께 확인

이 명령은 보행 모델만 불러옵니다. 앉기, 킥, 구르기는 해당 모델이 필요합니다. 로컬 스크립트의 Y와 브라우저 R처럼 키가 다르므로 실제 코드를 기준으로 보세요.

공개 전에 패키지 미리 검사

복사 가능한 예제
uv run publish --onnx first-walk.onnx \
  --repo YOUR_USERNAME/microduck-first-walk \
  --kind perpetual --slot walk --dry-run

YOUR_USERNAME을 바꾸세요. perpetual / walk는 지속 보행 정책용입니다. --dry-run은 모양, 기본 출력과 명세를 확인하고 로컬 패키지를 준비하지만 업로드하지 않습니다. publish-first-walk 폴더를 다시 만들므로 개인 메모는 밖에 두세요.

재생 결과와 출처를 함께 저장

시작, 정지, 회전과 복구 조건을 기록합니다. 유한한 출력이 나오는 것은 기본 검사일 뿐 실물 로봇 호환의 증거는 아닙니다.

계속하기 전에 확인

정책을 다른 로봇에 바로 복사할 수 있나요?

아니요. 관절 순서, 관측, 동작 스케일, 런타임과 부속 장치가 일치해야 합니다.

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

출처 확인일:

출처와 검토 (4)
  1. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/src/mjlab_microduck/export.py
  2. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/scripts/infer_policy.py
  3. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/src/mjlab_microduck/publish/cli.py
  4. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/README.md

다음에 읽을 가이드

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

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

MicroDuck 공식 참조 정책: 달리기·롤러·경사·앉기 비교

네 참조 모델의 슬롯, 서보, 부착물과 명령 의미를 비교합니다. 고정 버전 시험과 복원, 내장 정규화 및 학습 소스 접근 한계를 안내합니다.

MicroDuck 공식 정책 v8: walk 덮어쓰기 확인과 복원

10월 12일 공개된 velstand v8의 변경과 한계를 확인하고, 데몬과 별도인 정책 업데이트·개인 walk 덮어쓰기·한 슬롯만 공식 기본값으로 돌리는 절차를 안내합니다.