本文へ移動
原資料を確認

MicroDuck が動かないとき|読み込み・CUDA・モデルの切り分け

キーが効かない、Python の版が合わない、CUDA が見えない、ARM の取得が止まる、ONNX の形が違う。最初に失敗した段階を基準に次の確認を選びます。

ブラウザ、依存関係、学習初期化、モデル再生を別々に調べます。最初のエラーを残し、一度に変更する項目を絞ると、改善した理由を後から説明できます。

画面が出るのに操作できない

シーンへの入場、フォーカスとモードを確認します。R が座る動作になるのは現在のブラウザ仕様です。操作一覧とローカル Python ビューアーを混同しないでください。

Python や train の実体が違う

固定したリポジトリで uv run python --version を確認します。3.12 が対象です。別の train が動く場合も、uv run train を使い、同じ版を同期してから調べます。

CUDA が見つからない

診断コマンドを学習と同じ環境から実行します。OS、CPU アーキテクチャ、ドライバー、PyTorch と CUDA ビルドを記録します。Jetson Thor の報告は機種固有の問題で、すべての 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 ↗