Microduck - ONNX方策を実機制御につなぐRust製ロボット実行基盤

GitHub Stars11k
Stars Today319
Forks1.4k
Trending7
観測: 2026年10月25日

Microduckは、強化学習方策で動く小型二足歩行ロボットMicroduckの実行側を担う、Rust製のソフトウェアだ。別リポジトリのmicroduck_rlで学習してONNXへ出力した方策を読み込み、制御、操作入力、通信、設定、更新を実機上で扱う。設計の中心は、制御ループとモーターバスをrobotdに集約し、周辺機能を複数のデーモンへ分け、共通のJSON-RPC契約で接続することにある。 READMEによると、Rockchip RK3566上で50Hzの制御ループを動かし、15個のサーボを駆動する。ただし、これは保守者による構成の説明であり、測定手順を伴う性能検証ではない。取得資料はREADMEと開発リリースの説明が中心で、推論遅延、周期超過時の処理、安全停止、更新失敗からの復旧が成立する条件までは確認できない。

なぜ注目されているか

2026年10月25日の観測ではGitHub Trending日次7位で、当日増加として319スターが記録された。総スター数は10,975、フォーク数は1,406。開発者の関心を示す観測値であり、歩行性能や制御の安定性を裏付ける数値ではない。

なぜ重要なのか

学習済みモデルを物理システムへ接続すると、モデルの読み込みに加え、誰が制御を所有し、どの操作経路を受け付け、どう更新するかが問題になる。Microduckは、この実行と運用の責任をデーモン群として整理している。方策を作る側と機体を動かす側の境界が明確になれば、学習の変更と実機ソフトウェアの変更を分けて考えやすくなるだろう。ただし、その分業を実用上の契約にするには、ONNXという形式だけでなく、観測・行動テンソルの仕様や制御周期、安全条件まで確認する必要がある。

この記事に出てくる言葉(5語)
方策

ロボットの運動制御に使う学習済みモデル。Microduckでは学習側がONNXへ出力し、実行側が読み込む。

microduck_rl

MuJoCo、PPO、domain randomisation、sim2realとONNX出力を担当する、実行側とは別の学習用リポジトリ。

robotd

Microduckの制御ループとモーターバスを所有するデーモン。

共通JSON-RPC契約

デーモン間と各操作クライアントで共有する呼び出しインターフェース。デーモン群の通信にはUnixソケットを使う。

信頼鍵

署名済みリリースの受け入れを制御するための鍵。開発リリースを開発ボードで受け入れるには、開発用の公開鍵登録と設定が必要になる。

1. 読む前に知っておきたいこと

学習の成果物と、動き続ける機体の間

READMEが示す分業では、microduck_rlがMuJoCoとPPOによる方策学習、domain randomisation、sim2real、ONNX出力を担当する。本リポジトリは、そのONNXを読み込んでMicroduckを動かす側だ。学習を行いたい読者と、学習済み方策を実機へ接続したい読者では、調べるべきリポジトリが異なる。

この境界から見える課題は、学習成果物だけでは機体の稼働システムが完結しないことだ。方策を読み込んでも、周期的にサーボを動かす主体、操作入力の窓口、機体設定、ソフトウェア更新が必要になる。Microduckはそれらを実行側へまとめている。見るべき単位はモデル単体の実行ではなく、方策を組み込んだ制御・運用システムである。

操作経路を増やしても、制御の窓口をそろえる

Microduckにはアプリ、コンソール、ゲームパッド、スクリプトという複数の操作経路がある。READMEは、これらが同じJSON-RPC呼び出しを使うと説明する。各クライアントが個別の制御方式を持つ構成に対し、共通の呼び出し契約へ集約する設計だと読める。

ただし、操作のインターフェースが共通であることと、呼び出しの競合や権限がどう扱われるかは別の論点になる。取得資料から確かめられるのは、操作経路を共通契約へそろえ、制御ループとモーターバスの所有者をrobotdに置くという構成までだ。契約の具体的な仕様を確認せず、操作の調停方法まで推測することはできない。

なぜ注目されているか

2026年10月25日のGitHub Trending観測では、日次7位、当日319スター増、総10,975スター、1,406フォークを記録した。これは10月25日時点の注目度であり、公開予定日の10月27日の増加ではない。また、人々が何を評価したかを示す議論本文は取得されておらず、注目の理由を断定する材料もない。

技術的に掘り下げる足場はある。READMEは対象ハードウェア、制御周波数、サーボ数、方策形式、デーモンごとの役割を示している。外形的な人気と切り離して、学習成果物を機体へ接続する責任分界を検討できる点が、本記事で扱う理由になる。スター数は、その構成が安全に動く証拠にはならない。

2. どう動くのか

ONNXを境界に、学習と実行を分ける

処理の流れは、学習側で方策を作り、ONNXへ出力し、実行側がそれを読み込むという順序になる。MicroduckはRustの単一ワークスペースで構成され、READMEはフレームワークを使わないと説明している。ここで読み取れる中心的な抽象は、学習の成果を方策という読み込み対象にし、機体を動かす責務を実行ソフトウェアへ置くことだ。

READMEによると、車輪を装着してroller modeを指定した場合は別の方策を読み込む。動作形態の違いを、読み込む方策の違いとして扱う例である。ただし、この説明から任意のONNXモデルを交換可能とは判断できない。取得資料ではモデルの入手方法や観測・行動テンソルの仕様が確認できず、実行側がモデルに要求する契約の詳細は残っている。

robotdが制御ループとモーターバスを所有する

実機制御の中心はrobotdだ。制御ループとモーターバスをこのデーモンへ集約し、周辺の通信や設定とは責務を分ける。READMEによると、対象はRockchip RK3566搭載Microduckで、50Hzの制御ループが神経方策から15個のサーボを駆動する。この数値は、対象構成を理解するための保守者による記載値として読む必要がある。

確認できる実行経路は、ONNX方策の読み込みと、robotdによる制御ループ・モーターバスの管理までだ。センサー入力から観測テンソルを作る処理、推論器、行動の変換、サーボへの書き込みをつなぐ詳細は取得資料にない。したがって、モデル出力をどう実機へ対応付けるかや、各処理の時間配分は説明できない。

特に50Hzという記載は、周期が守られるという保証ではない。推論遅延、周期のばらつき、周期超過率、スケジューリング、超過時の処理、測定手順は示されていない。制御をrobotdが所有するという構造と、その制御が時間制約を満たすという実証は分けて評価すべきだ。

周辺デーモンを共通契約で接続する

周辺機能は役割ごとに分かれる。configdはWi-Fiと機体の識別情報、btdはスマートフォン向けBluetooth経路、paddはゲームパッド入力を担当する。mediadはカメラをWebRTCで配信し、tofdは深度センサーを提供する。映像や深度センサーの担当は明示されているが、それらが方策の観測入力へどう接続されるかまでは確認できない。

デーモン群はUnixソケット上の共通JSON-RPC契約で通信する。機体内部の通信と、スマートフォン向けBluetooth、カメラ配信用WebRTCという外部との経路を区別すると、構成を追いやすい。さらにduckctlには、ネットワークやSSHを使わず、ノートPCからBluetooth経由で機体を操作する経路がある。

アプリやスクリプトなどの入口を共通の呼び出しへそろえることで、利用者側の操作経路と、制御を所有するrobotdを分ける設計と読める。ただし、JSON-RPCの採用だけではAPIの安定性、アクセス権、デーモン間の障害の伝わり方までは判断できない。これらは実装や契約の詳細を確認すべき項目として残る。

更新の境界には署名と健全性確認を置く

更新はupdaterdが担当する。保守者の説明では、署名済みリリースを導入し、起動後に機体が不健全であればロールバックする。更新を配布とインストールだけで終わらせず、検証、起動後の健全性確認、復旧まで含めて扱う構成だ。ただし、取得資料にはその実装や失敗試験の結果がなく、何を健全と判断し、どの失敗から戻れるかは確認できない。

開発リリースには具体的な受け入れ条件がある。team.devで署名されており、顧客機では拒否される。開発ボードで受け入れるにはteam.dev.pubを信頼鍵へ登録し、allow_dev_keys = trueを設定する必要がある。開発ビルドを試す経路は、署名と信頼設定の変更を伴う。署名を受け入れる条件と、更新後に正常動作できる条件は、それぞれ確かめる必要がある。

シミュレーションでも実際のデーモンを使う

READMEによると、scripts/duck-simは実際のデーモンをMuJoCoの機体に対して動かす。これは方策の学習だけを試す経路とは異なり、実行側のシステム構成を実機なしで調べる入口になると考えられる。ただし、シミュレーションの動作も保守者の説明に基づくもので、ここで確認した実行結果ではない。

実機側の開発では、ブランチビルドを開発ボードへ導入する経路と、ローカルでビルドしてSSH経由で導入する経路が紹介されている。シミュレーションで構成を試す段階と、対象機体で動作を確認する段階を持てる一方、前者だけで実機の制御周期、安全停止、更新復旧まで検証済みとは扱えない。

3. 使いどころと限界

実機の実行と運用をまとめて扱う開発に合う

最も直接的な用途は、Microduck実機でONNX方策の実行、サーボ制御、操作入力、設定、更新をまとめて扱う開発だ。機能ごとのデーモンと共通RPCを手掛かりに、制御へ何を集約し、周辺へ何を分担するかを調べる用途にも適すると考えられる。実機がない場合には、scripts/duck-simがシステム構成を試す候補になる。

microduck_rlとの関係は補完である。学習、sim2real、ONNX出力が目的なら学習側を参照し、その成果を機体へ接続するなら実行側を見る。Microduckが学習用の基盤を置き換えるとは整理できない。取得資料に比較可能な競合の一次情報はなく、他のロボット実行基盤に対する性能や機能の優劣も判断できない。

ONNX形式だけでは接続条件はそろわない

採用判断で先に確認したいのは、モデルの入手方法、観測・行動テンソルの仕様、モデル固有のライセンスだ。実行側リポジトリのメタデータ上のライセンスはApache-2.0だが、その情報から別リポジトリやONNXモデルへの適用範囲まで広げることはできない。学習成果物を用意できるかと、利用条件を満たせるかは別々に確認する必要がある。

また、READMEが示す実行対象はRockchip RK3566搭載Microduckである。他のロボットや基板への移植手順、対応するサーボ構成の範囲は取得資料にない。汎用のONNX実行基盤として任意の機体へそのまま適用する用途には、判断材料が不足する。単一ワークスペースやデーモン分割という構造だけを根拠に、移植の容易さまでは評価できない。

起き上がりと安全停止は別に評価する

READMEには転倒後の起き上がりが紹介されている。しかし、転倒、通信断、異常なセンサー入力に対する停止条件や、安全性の検証結果は示されていない。動作として起き上がれるという説明から、異常時の安全性を導くことはできない。

厳密なリアルタイム性や安全停止の保証を公開測定値で審査する用途では、現在の取得資料は不足している。デーモンの役割や50Hzという記載は調査の出発点になるが、運用条件を決める証拠には足りない。同様に、署名検証とロールバックの説明も、更新失敗から復旧できる範囲の実証としては扱えない。

運用の責任は、機能一覧の先に残る

Microduckは制御だけでなく、通信、映像、設定、更新まで実行側の構成に含める。その分担が開発に合うかは、各機能の接続条件と失敗時の挙動を確認して判断する必要がある。共通RPCがあることからAPIの成熟度を、Rust製であることから制御性能を推定することはできない。

導入や調査に必要な作業としては、モデル契約の確認、対象機体での周期測定、安全条件の確認、更新失敗時の検証が残る。これらにかかる時間や運用費用を見積もれる資料はない。実機制御と周辺運用がまとまっている点に価値を見いだしつつ、公開説明で確認できる構成と、自分たちの用途で検証すべき条件を対応付ける読み方が適している。

このツールから考える

ここからは、一次情報と限界を踏まえた編集上の考察です。

Microduckの構成から考えたいのは、学習成果物を受け取る側の責任だ。方策は別リポジトリからONNXとして渡され、robotdが制御ループとモーターバスを所有する。周辺機能はデーモンへ分かれ、操作経路は共通JSON-RPCへ集まる。この分離が機能すれば、モデル開発とは別に、機体を稼働させ続ける実行基盤の責務を整理しやすくなる。

ただし、その境界はファイル形式だけでは完成しない。観測・行動テンソルの仕様、周期超過時の挙動、安全停止、更新後の健全性が確認できて初めて、学習側と実行側が何を引き受けるかを具体化できる。Microduckが示す設計を評価するうえで次に見るべきものは、方策の能力とともに、その能力を実機へ接続する契約と失敗条件がどこまで検証可能になるかである。

検証に使用した一次情報

DevTool Lensでは、第三者の二次情報やREADMEの宣伝文句に依存せず、以下の公式リポジトリ・ドキュメント・リリース情報を精査して記事を作成しています。