학습부터 배포까지의 순서
- MicroDuck RL 저장소 읽기 | 환경·클라우드·모델 기록
공식 RL 저장소가 설치, 학습과 내보내기의 기준입니다. 여기에 한국어 개인 모델 카드를 함께 읽으면 실행뿐 아니라 결과를 어떻게 기록할지 참고할 수 있습니다. 각 문서가 사용한 버전은 따로 확인해야 합니다.
- MicroDuck 첫 학습 실행 | CUDA 확인·짧은 시험·클라우드 미리보기
같은 프로젝트 환경에서 CUDA가 보이는지 먼저 확인한 뒤 짧은 설치 시험을 실행합니다. 64개 환경과 5회 반복은 이 사이트가 정한 점검 설정으로 공식 성능 기준이 아닙니다. 명령은 소스와 대조했지만 여기서 GPU 학습을 실행하지는 않았습니다.
- MicroDuck ONNX 변환·재생 | 정규화와 61 입력 확인
체크포인트 확장자를 바꾸는 대신 해당 태스크의 공식 내보내기를 사용하세요. 관측 정규화까지 포함해 현재 관측 61개·행동 14개의 의미와 순서를 맞춰야 올바른 재생을 확인할 수 있습니다.
- 마이크로덕 시뮬레이터 | 공개 동작 불러오기와 원래 동작 복원
공식 시뮬레이터에서 Waddle In으로 시작해 방향키로 기본 걷기를 확인하세요. 공개 정책은 ?move=소유자/저장소 링크로 불러옵니다. PLAYING은 불러온 상태이지 현재 구동 중이라는 뜻이 아니며, ✕를 누르면 해당 슬롯의 공식 동작이 돌아옵니다. 10월 12일 공식 sprint 참고 모델의 불러오기와 해제를 확인했습니다.
- MicroDuck 공식 정책 v8: walk 덮어쓰기 확인과 복원
공식 velstand v8은 10월 12일 공개됐지만 데몬 업그레이드만으로 현재 기체가 이를 사용한다고 볼 수 없습니다. policy list와 check를 비교하고 필요할 때 공식 정책 세트를 업데이트하세요. 수동 로드한 walk는 남으므로 공식 기본값으로 돌아갈 때만 reset walk를 실행합니다.
ONNX를 전체 학습 저장본으로 보지 않기
RL 변경은 bae39f59에 병합됐고 공개 학습 저장소 64d28ce0에 bundle 9개가 있습니다. 새로 공유된 출처 정보이지 새로운 실물 성적 9개가 아닙니다. 확인한 정책 집합은 v8이며 actor ONNX에는 일반 재개에 필요한 critic·optimizer·커리큘럼 상태가 없습니다.
velstand 예는 10월 12일 실행의 2749회차로 v8 velstand.onnx, 학습 커밋 37507767과 두 교사를 기록합니다. 교사는 on_remote:false이지만 이번 확인에서 두 커밋을 GitHub로 직접 읽을 수 있어 이 표시만으로 소스 부재를 판단할 수 없습니다. 반면 roulade에는 코드 커밋이 없습니다. velstand의 uncommitted.diff는 깨끗한 Git 상태와 빈 diff이므로 기계적으로 적용하지 말고 내용을 확인하세요.
- task_id·checkpoint_file·checkpoint_sha256을 맞추고 ONNX 해시와 구분합니다.
- code.commit·on_remote·설정·diff 내용을 읽습니다. 학습 당시 커밋과 새 해석기 커밋은 역할이 다릅니다.
- 각 교사 bundle과 필요한 소스를 확인합니다. 공개 가중치만으로 누락 코드·접근 권한·환경을 채울 수 없습니다.
이어 학습·warm start·공유를 따로 선택
새 해석기는 로컬 .pt 또는 hf://owner/repo@revision/path를 받습니다. 같은 작업의 --init-checkpoint는 회차·커리큘럼을 이어갑니다. MICRODUCK_WARM_START=1은 다른 작업에서 로드된 모델 상태를 유지하며 커리큘럼을 초기화합니다. 이전 resume 인자와 섞지 말고 오래된 학습 소스가 새 CLI를 지원하는지 먼저 확인하세요.
share-training이나 publish --share-training을 직접 선택해야 업로드됩니다. 새 저장소는 기본 비공개이며 --public을 선택해야 공개됩니다. 게시 전 출처와 diff를 검토하세요. 이 사이트는 코드·메타데이터 9개·작은 참고 파일만 읽었고 체크포인트 다운로드·로딩·학습·보행 재현·HD1910 호환 검증은 하지 않았습니다.
Windows에서는 먼저 WSL 상태 확인
Microsoft의 한국어 설치 안내는 Windows 10 버전 2004·빌드 19041 이상 또는 Windows 11을 기준으로 WSL 설치를 설명합니다. 이를 완료해도 MicroDuck 학습 환경이 자동으로 준비되는 것은 아닙니다. NVIDIA CUDA on WSL에서 GPU 드라이버와 지원 조건을 이어서 확인하세요.
Python 환경을 섞지 않기
Windows의 Python, WSL의 Python, 프로젝트 가상환경은 서로 다릅니다. 학습할 환경에서 버전과 CUDA를 진단해야 합니다. 이 사이트는 WSL에서 MicroDuck 학습을 직접 재현하지 않았습니다.
Linux에서 확인할 항목
드라이버, PyTorch CUDA 빌드와 CPU 아키텍처를 맞춥니다. 첫 실행 안내의 진단은 GPU가 보이는지 확인하며 모든 태스크를 처리할 VRAM이 충분한지 측정하지 않습니다.
Mac과 GPU 없는 환경
브라우저로 기존 동작을 볼 수 있습니다. CPU ONNX 재생에도 Python 의존성과 뷰어 자산이 필요합니다. 클라우드를 선택해도 로컬 실행기의 설치 문제가 사라지지는 않으므로 사전 확인을 진행하세요.
한국어 실험 기록으로 평가 감각 익히기
Brunocho의 모델 카드는 서로 다른 체크포인트를 비교한 개인 기록입니다. 반복 횟수를 늘리는 것만으로 결과가 좋아지지는 않는다는 평가 관점을 참고할 수 있습니다. 수치는 작성자 자체 시험이며 이 사이트나 실물 로봇의 성능 측정이 아닙니다.
CUDA가 없는 Apple Silicon Mac의 연구 경로
jonathanhawkins의 Microduck Lab은 2026년 9월 22일 갱신된 독립 프로젝트입니다. Apple Silicon CPU에서 보상 설계와 동작 학습을 시험하는 도구이며 설치 스크립트가 상위 모델·정책 버전을 고정하고 계약 검사를 실행합니다. 새 작업 디렉터리에서 요구 사항을 확인한 뒤 진행하고 커밋, ONNX와 평가 조건을 남기세요. 작성자가 보고한 호환성이나 성능은 이 사이트와 제조사의 실물 검증이 아닙니다. 실제 robotd 소프트웨어를 점검하려면 공식 데몬 시뮬레이션을 참고하세요.
계속하기 전에 확인
ONNX 파일에 전체 학습 상태가 들어 있나요?
아니요. 실행용 actor 파일은 optimizer, critic, curriculum을 포함한 학습 재개 상태와 다릅니다.
적용 범위: Pollen Robotics MicroDuck. 모델, 이미지, 소프트웨어, 드라이버 버전을 함께 기록하세요. 날짜별 설명은 원래 검증 범위를 유지합니다.
출처 확인일:
출처와 검토 (18)
- github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/README.md
- github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/pyproject.toml
- docs.nvidia.com/cuda/wsl-user-guide/index.html
- github.com/pollen-robotics/microduck_rl/issues/38
- github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/scripts/hf/README.md
- huggingface.co/docs/hub/jobs-pricing
- github.com/jonathanhawkins/microduck-lab/tree/47c62e3fb5193191d6d7e1181cc61089eaa768c7
- github.com/pollen-robotics/microduck_rl/blob/bae39f5900b318f7e87fc485c30a31213cfa14eb/docs/training_checkpoints.md
- huggingface.co/pollen-robotics/microduck-training/blob/64d28ce092253c509b51031ec7ccb53790a00d0d/README.md
- huggingface.co/pollen-robotics/microduck-training/blob/64d28ce092253c509b51031ec7ccb53790a00d0d/bundles/velstand/0045i2si_2749/bundle.json
- github.com/pollen-robotics/microduck_rl/blob/bae39f5900b318f7e87fc485c30a31213cfa14eb/src/mjlab_microduck/checkpoints.py
- github.com/pollen-robotics/microduck_rl/blob/bae39f5900b318f7e87fc485c30a31213cfa14eb/src/mjlab_microduck/publish/training.py
- github.com/pollen-robotics/microduck_rl/blob/bae39f5900b318f7e87fc485c30a31213cfa14eb/src/mjlab_microduck/train_hook.py
- huggingface.co/pollen-robotics/microduck-policies/blob/665ae4eb20bfe13bca1ef4ea6d4bb6b4a096e448/manifest.json
- github.com/pollen-robotics/microduck_rl/commit/85105f4b135e548f4df791227d2eed12de0bef2c
- github.com/pollen-robotics/microduck_rl/commit/2f1f76bc6abb4df32ebf46510215b3d2c497c2b9
- learn.microsoft.com/ko-kr/windows/wsl/install
- huggingface.co/Brunocho/microduck-walk/blob/d5f14f81948e6da4263f1f0b566ba101b3c558fa/README.md
다음에 읽을 가이드
MicroDuck 첫 학습 실행 | CUDA 확인·짧은 시험·클라우드 미리보기
소스를 고정하고 Python 3.12 환경에서 CUDA와 태스크를 확인합니다. 64개 환경·5회 반복으로 설치를 점검한 뒤 체크포인트를 보관하고 클라우드 작업 사양을 미리 봅니다.
MicroDuck ONNX 변환·재생 | 정규화와 61 입력 확인
훈련 체크포인트를 공식 내보내기로 변환하고 관측 정규화를 유지합니다. 현재 입력 레이아웃으로 재생한 뒤 모델 패키지를 미리 검사하고, 이전 정책과 실물 배포의 차이를 확인하세요.
MicroDuck 공식 참조 정책: 달리기·롤러·경사·앉기 비교
네 참조 모델의 슬롯, 서보, 부착물과 명령 의미를 비교합니다. 고정 버전 시험과 복원, 내장 정규화 및 학습 소스 접근 한계를 안내합니다.