本文へ移動
原資料を確認

MicroDuck 初回学習の手順|環境確認から短い試行まで

公式コードの版を固定し、Python と CUDA、タスク登録を確認。小さな学習で導入を確かめ、チェックポイントを保存し、クラウド実行前の仕様をプレビューします。

まず環境を固定し、同じ Python から CUDA が見えるか確認します。64 環境・5 反復は当サイトが用意した短い導入確認の設定で、公式ベンチマークではありません。コマンドはソース確認済みですが、GPU 学習は当サイトで実行していません。

1. 別フォルダーに環境を作る

Git と uvを準備し、microduck-rl-first-run が存在しない親フォルダーから実行します。

コピーできる例
git clone https://github.com/pollen-robotics/microduck_rl.git microduck-rl-first-run
cd microduck-rl-first-run
git checkout --detach 2b25a48b08f1f17bc38c90bb03144c81fbd9ed07
uv python install 3.12
uv sync --locked --python 3.12

確認した版は 2b25a48、Python は 3.12 です。--locked で依存関係を固定し、不一致が出たらロックファイルを消す前にエラーを保存します。

2. 同じ環境で診断する

コピーできる例
uv run python - <<'PY'
import sys, torch
print('Python:', sys.version)
print('PyTorch:', torch.__version__)
print('CUDA build:', torch.version.cuda)
print('CUDA available:', torch.cuda.is_available())
print('GPU count:', torch.cuda.device_count())
PY

Python 3.12.x、CUDA available: True、GPU count が 1 以上かを見ます。次の出力に Mjlab-Velocity-Flat-MicroDuck があることも確認します。

コピーできる例
uv run list-envs

3. 導入を短い実行で確かめる

コピーできる例
uv run train Mjlab-Velocity-Flat-MicroDuck \
  --env.scene.num-envs 64 \
  --agent.max_iterations 5

実際にローカル GPU を使います。環境が初期化され、例外なく反復ログが進めば導入確認の目安になります。5 反復で歩行を習得することは期待しません。ログサービスの設定を求められたら対応し、同じ条件で再確認します。

4. 結果を再利用できる形で保存

チェックポイントの実在パス、タスク、設定、種、環境を残します。.pt の拡張子を変えるだけでは ONNX になりません。書き出しと再生へ進んでください。

5. クラウドは仕様の確認から

コピーできる例
uv run train Mjlab-Velocity-Flat-MicroDuck \
  --env.scene.num-envs 64 \
  --agent.max_iterations 5 \
  --hf-jobs --timeout 1h --dry-run

設定済み環境でローカルのソースアーカイブを作り、ジョブ仕様を表示します。--dry-run 付きでは GPU ジョブを送信しません。ハードウェア、名前空間、アーカイブ内のファイルを確認し、秘密情報を含めないでください。1h は時間上限の例です。

実行前に料金条件を確認します。Ctrl-C はログの追跡を止めるだけで、遠隔ジョブは停止しません。管理方法に従って取り消し、停止状態まで確認します。

続ける前に確認

短い動作確認が通れば全学習も成功しますか?

いいえ。導入と小規模実行の確認です。メモリ、タスク設定、学習時間、結果は別に評価します。

対象: Pollen Robotics MicroDuck. モデル、イメージ、ソフトウェア、ドライバーの版を一緒に記録します。各日付の説明は元の検証範囲を維持します。

出典確認日:

出典と確認 (9)
  1. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/README.md
  2. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/pyproject.toml
  3. docs.astral.sh/uv/guides/install-python/
  4. docs.astral.sh/uv/concepts/projects/sync/
  5. docs.pytorch.org/docs/stable/generated/torch.cuda.is_available.html
  6. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/scripts/hf/README.md
  7. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/src/mjlab_microduck/hf_jobs.py
  8. huggingface.co/docs/hub/jobs-pricing
  9. huggingface.co/docs/hub/jobs-manage

次に読むガイド

MicroDuck学習から配備へ:準備・学習・書き出し・検証

準備、ローカル学習、書き出し、シミュレーション再生、配備確認の順に進みます。書き出しやアップロードの成功は実機での方策実行を証明しません。

MicroDuck の ONNX 書き出しと再生|入力仕様を揃える

チェックポイントを公式の書き出し処理に渡し、観測の正規化と 61 入力を保ったまま再生。旧モデルとの差、キー配置、公開パッケージの事前確認を説明します。

MicroDuckのトラブル対処:更新・ペアリング・ポリシー

MicroDuck 0.20.1:復旧の前に接続経路を確認. Wi-Fi SSHは機体のそばで有効にする方式です。daemon/APIとSetup Codeを確認し、接続拒否と更新失敗を切り分けます。