본문으로 이동
원문 확인

MicroDuck 오류 해결 | WSL·CUDA·Python·ONNX 단계별 점검

로딩 멈춤과 키 입력 문제, Python 3.12 불일치, CUDA 미인식, ARM 다운로드 시간 초과와 ONNX 차원 오류를 구분합니다. 첫 오류와 마지막 성공 단계로 다음 확인을 정하세요.

처음 실패한 단계부터 진단하세요. 브라우저 로딩, Python 가져오기, 학습 초기화와 ONNX 추론은 다른 문제입니다. 드라이버·모델·Python을 한꺼번에 바꾸면 원인을 찾기 어려워집니다.

장면은 보이지만 움직이지 않을 때

진입 화면, 포커스와 현재 모드를 확인합니다. 브라우저의 R은 앉기·서기입니다. 조작 안내와 로컬 Python 뷰어의 키를 구분하세요.

설치한 Python과 실행한 Python이 다를 때

고정한 저장소에서 uv run python --version을 실행합니다. 대상은 3.12입니다. Windows와 WSL의 환경을 섞지 말고 환경 안내로 돌아가 확인하세요. train 충돌은 우선 uv run train과 같은 커밋의 동기화로 점검합니다.

CUDA가 False 또는 GPU가 0개일 때

진단 명령을 학습 환경 안에서 실행해 OS, 아키텍처, 드라이버, PyTorch와 CUDA 빌드를 기록합니다. Jetson Thor 이슈는 기기별 의존성 문제로 모든 ARM 장치의 해결법이 아닙니다.

ARM 패키지 다운로드가 시간 초과일 때

공식 빠른 시작은 큰 패키지 다운로드 시간을 늘리는 설정을 안내합니다. 아래는 통신 시간 초과를 위한 것이며 드라이버나 바이너리 호환을 수정하지 않습니다.

복사 가능한 예제
UV_HTTP_TIMEOUT=600 uv sync --locked --python 3.12

ONNX 입력 차원이 맞지 않을 때

현재는 관측 61개, 행동 14개입니다. 이전 51 입력 정책은 이전 레이아웃과 맞아야 합니다. 빈 값을 채워 모양만 맞추지 말고 순서, 정규화와 타이밍도 확인하세요. 내보내기 안내에 해당 경로가 있습니다.

질문에 첨부할 최소 기록

복사 가능한 예제
목표와 마지막 성공 단계:
원문 URL과 소스 커밋:
OS / 아키텍처 / 브라우저 또는 Python:
GPU / 드라이버 / PyTorch / CUDA:
전체 실행 명령:
첫 오류와 앞뒤 로그:
이미 시도한 변경:

토큰과 비밀번호를 지우고 기술 질문으로 공유하세요. 마지막으로 성공한 단계가 다음 확인을 고르는 데 도움이 됩니다.

출처와 확인 날짜

자료 확인일 2026년 9월 8일 · 원문 확인

  1. 원문 자료 1 · huggingface.co / README.md ↗
  2. 원문 자료 2 · huggingface.co / keyboard.js ↗
  3. 원문 자료 3 · github.com / pyproject.toml ↗
  4. 원문 자료 4 · docs.pytorch.org / torch.cuda.is_available.html ↗
  5. 원문 자료 5 · github.com / 38 ↗
  6. 원문 자료 6 · github.com / infer_policy.py ↗
  7. 원문 자료 7 · github.com / export.py ↗
  8. 원문 자료 8 · github.com / README.md ↗
  9. 원문 자료 9 · huggingface.co / jobs-manage ↗