fujitatomoya/ros2ai

これは何？

主な機能

• 01ROS 2に関する質問に回答し、対応するros2コマンドを提案します。
• 02ノードの一覧表示やトピックの詳細表示など、自然言語での依頼を実行します。
• 03OpenAIのモデル、またはOpenAI互換エンドポイント経由でローカルのOllamaサーバーを利用できます。
• 04モデル、エンドポイント、temperatureを環境変数で設定できます。
• 05DebianパッケージまたはDockerイメージとして利用でき、colconでビルドできます。

ユースケース

• 初心者や学生がROS 2のCLIコマンドを学ぶ。
• ドキュメントを調べずに、タスクに合ったros2コマンドをすばやく確認する。
• ローカルのOllamaモデルを使い、クラウドAPIにリクエストを送らずにROS 2システムへ問い合わせる。

クイックスタート

1. 1

   ROS 2 Kilted 用のバイナリパッケージをインストールする

   apt install ros-kilted-ros2ai
2. 2

   必要な Python パッケージ（rolling、kilted、jazzy）をインストールする

   pip install openai ollama validators --break-system-packages --ignore-installed
3. 3

   OpenAI API キーを設定するか、Ollama をセットアップしてモデルを pull する

   export OPENAI_API_KEY='your-api-key-here'

使う前に知っておきたいこと

• !OpenAI API キー、またはモデルをダウンロード済みの Ollama サービスが必要です。
• !一部の環境ではリリース済みパッケージがないため、colcon ワークスペースでソースからビルドする必要があります。
• !対応しているディストリビューションは ROS 2 Humble、Jazzy、Kilted、Rolling のみです。

収録されている特集

トピック

よくある質問

ros2ai とは？

OpenAIまたはOllamaのLLMを使い、自然言語でROS 2のコマンドを質問・調査・実行できるROS 2 CLI拡張です。 ros2aiは、AIを活用したサブコマンドをROS 2 CLIに追加します。正確なCLI構文を調べる代わりに、ROS 2について質問したり、平易な言葉で操作を指示したりできます。ros2cliにまだ慣れていない初心者や学生を対象としています。

ros2ai は無料で使えますか？ライセンスは？

ros2ai は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

ros2ai は今もメンテナンスされていますか？

活発にメンテナンス中。ros2ai の最終コミットは 2026年11月7日 です。

ros2ai は何に使えますか？

初心者や学生がROS 2のCLIコマンドを学ぶ。 ドキュメントを調べずに、タスクに合ったros2コマンドをすばやく確認する。 ローカルのOllamaモデルを使い、クラウドAPIにリクエストを送らずにROS 2システムへ問い合わせる。

ros2ai のインストール方法は？

ROS 2 Kilted 用のバイナリパッケージをインストールする: apt install ros-kilted-ros2ai 必要な Python パッケージ（rolling、kilted、jazzy）をインストールする: pip install openai ollama validators --break-system-packages --ignore-installed OpenAI API キーを設定するか、Ollama をセットアップしてモデルを pull する: export OPENAI_API_KEY='your-api-key-here'

ros2ai はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/fujitatomoya/ros2ai