ros2-gpt 0.1.0

AI-powered ROS 2 development assistant

ROS2-GPT

AI-powered ROS 2 development assistant — workspace scanning, package parsing, dependency analysis, build error diagnosis, code generation, and more.

Features

Feature	Description
Workspace Scanner	Discover packages, categorize 15+ file types, incremental re-indexing (<30s for 100 packages)
Package Parser	Parse package.xml, CMakeLists.txt, setup.py, launch files, URDF/Xacro
Dependency Graph	NetworkX DAG with cycle detection, topological build order, DOT/Mermaid/JSON export
LLM Integration	Multiple providers (Ollama, OpenAI-compatible), code explanation, package generation
RAG Pipeline	ChromaDB vector search, documentation indexing (ROS2 core, Nav2, MoveIt2, etc.), workspace memory
Code Generation	C++/Python nodes (pub/sub, services, actions, lifecycle, composable), launch files, interfaces
Build Analysis	Log parsing, CMake/package.xml validation, QoS mismatch, TF errors, URDF/Xacro validation, DDS issues
REST API	13 endpoints + WebSocket — integrate with any frontend
Desktop UI	PySide6 tabbed interface with dashboard, scanner, graph, build analyzer, generator, settings
VS Code Extension	Tree view, commands, diagnostics integration

Quick Start

pip install -e ".[dev]"
ros2-gpt scan /path/to/ros2_workspace

Installation

Basic

pip install -e .

With all extras

pip install -e ".[all]"

Optional dependency groups

Group	Includes
[ai]	sentence-transformers, chromadb, openai, ollama
[gui]	PySide6 (desktop UI)
[server]	fastapi, uvicorn, websockets (REST API)
[dev]	pytest, mypy, ruff, pre-commit

CLI Commands

Workspace & Package

ros2-gpt scan <workspace>          # Scan workspace
ros2-gpt parse <package>           # Parse a package
ros2-gpt graph <workspace>         # Generate dependency graph
ros2-gpt deps <workspace> <pkg>    # Show deps for a package
ros2-gpt stats <workspace>         # Workspace statistics
ros2-gpt launch <file>             # Parse launch file
ros2-gpt urdf <file>               # Parse URDF/Xacro file

Build Analysis

ros2-gpt analyze-build-log <file>           # Analyze colcon build log
ros2-gpt check-cmake <file>                 # Check CMakeLists.txt
ros2-gpt check-package-xml <file>           # Check package.xml
ros2-gpt check-qos <file>                   # Check QoS mismatches
ros2-gpt check-tf-log <file>                # Check TF issues in logs
ros2-gpt check-tf-code <file>               # Check TF issues in code
ros2-gpt check-urdf <file>                  # Check URDF validity
ros2-gpt check-xacro <file>                 # Check Xacro validity
ros2-gpt check-dds-log <file>               # Check DDS issues in logs
ros2-gpt check-dds-config <file>            # Check DDS configuration

REST API

# Start the server
python -m ros2_gpt.api.server

# Health check
curl http://127.0.0.1:8420/health

Full swagger docs at http://127.0.0.1:8420/docs

Desktop UI

python -m ros2_gpt.ui

VS Code Extension

See vscode-extension/ for setup instructions.

Development

make install-dev     # pip install -e ".[all]"
make lint            # ruff check
make typecheck       # mypy
make test            # pytest
make test-cov        # pytest with coverage

Architecture

ros2_gpt/
├── config/           # Pydantic settings
├── logging/          # Structured logging
├── plugins/          # Plugin system
├── scanner/          # Workspace discovery
├── parser/           # ROS2 file parsers
├── graph/            # Dependency graph
├── llm/              # LLM provider abstraction
├── ai/               # AI engine, prompts
├── vector_db/        # ChromaDB wrapper
├── search/           # Semantic search
├── docs/             # Documentation indexer
├── memory/           # Workspace memory
├── rag/              # RAG pipeline
├── generator/        # Code generation
├── build_analysis/   # Build error diagnosis
├── api/              # REST API + WebSocket
├── ui/               # Desktop UI (PySide6)
└── cli/              # CLI commands

License

MIT