Main
Use it as a ros2cli copilot: ask questions, generate commands, and run common ROS 2 tasks without switching contexts.
Prefer Ollama for local-first experimentation: set
OPENAI_ENDPOINTto the local OpenAI-compatible endpoint and unset the API key.Validate configuration with
ros2 ai status -vbefore relying on it in tutorials or live robot sessions.
Source-backed notes
- README calls ros2ai a ROS 2 CLI extension that works with OpenAI and Ollama via the OpenAI Python API.
- README lists supported ROS distributions (Rolling, Jazzy, Humble, etc.) and provides an apt-based install for some distros.
- README includes a Docker quickstart and documents env vars like
OPENAI_API_KEY,OPENAI_ENDPOINT, and model selection.
FAQ
- Do I need OpenAI?: No — README notes Ollama works via an OpenAI-compatible endpoint; the API key can be unset.
- Is it production-safe?: Treat it as an assistant; validate commands before running on real hardware.
- How do I pick a model?: README documents
OPENAI_MODEL_NAME; choose a smaller local model first for fast iteration.