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())
PYPython 3.12.x、CUDA available: True、GPU count が 1 以上かを見ます。次の出力に Mjlab-Velocity-Flat-MicroDuck があることも確認します。
uv run list-envs3. 導入を短い実行で確かめる
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)
- github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/README.md
- github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/pyproject.toml
- docs.astral.sh/uv/guides/install-python/
- docs.astral.sh/uv/concepts/projects/sync/
- docs.pytorch.org/docs/stable/generated/torch.cuda.is_available.html
- github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/scripts/hf/README.md
- github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/src/mjlab_microduck/hf_jobs.py
- huggingface.co/docs/hub/jobs-pricing
- huggingface.co/docs/hub/jobs-manage
次に読むガイド
MicroDuck学習から配備へ:準備・学習・書き出し・検証
準備、ローカル学習、書き出し、シミュレーション再生、配備確認の順に進みます。書き出しやアップロードの成功は実機での方策実行を証明しません。
MicroDuck の ONNX 書き出しと再生|入力仕様を揃える
チェックポイントを公式の書き出し処理に渡し、観測の正規化と 61 入力を保ったまま再生。旧モデルとの差、キー配置、公開パッケージの事前確認を説明します。
MicroDuckのトラブル対処:更新・ペアリング・ポリシー
MicroDuck 0.20.1:復旧の前に接続経路を確認. Wi-Fi SSHは機体のそばで有効にする方式です。daemon/APIとSetup Codeを確認し、接続拒否と更新失敗を切り分けます。