ros2-gpt 0.1.0__tar.gz

ros2_gpt-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,71 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - run: pip install -e ".[dev]"
+      - run: ruff check ros2_gpt tests
+      - run: mypy ros2_gpt --ignore-missing-imports
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - run: pip install -e ".[dev]"
+      - run: pytest --cov=ros2_gpt --cov-report=xml --cov-report=term -v
+      - uses: codecov/codecov-action@v3
+        with:
+          file: ./coverage.xml
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install build
+      - run: python -m build
+
+  vscode-extension:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: vscode-extension
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
+          cache-dependency-path: vscode-extension/package-lock.json
+      - run: npm ci
+      - run: npm run compile
+      - run: npm run lint

ros2_gpt-0.1.0/.gitignore

@@ -0,0 +1,42 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Test / coverage
+.pytest_cache/
+coverage/
+htmlcov/
+.coverage
+.coverage.*
+
+# Environment
+.env
+.venv/
+venv/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# VS Code extension
+vscode-extension/node_modules/
+vscode-extension/out/
+vscode-extension/*.vsix
+
+# Documentation
+site/

ros2_gpt-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,19 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.2.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.8.0
+    hooks:
+      - id: mypy
+        args: [--ignore-missing-imports]
+        additional_dependencies: [pydantic]
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files

ros2_gpt-0.1.0/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## [0.1.0] - 2026-06-30
+
+### Added
+- Phase 1: Core structure, scanning, parsing, dependency graph, CLI (7 commands)
+- Phase 2: LLM provider abstraction (Ollama, OpenAI), AI engine with 7 prompt templates
+- Phase 3: Documentation indexing (15 sources), workspace memory, RAG pipeline
+- Phase 4: Code generation (C++/Python nodes, launch files, interfaces, package scaffolding)
+- Phase 5: Build analysis (build log parser, CMake/package.xml/QoS/TF/URDF/Xacro/DDS detectors)
+- Phase 6: REST API (13 endpoints), WebSocket support, CLI enhancements (8 new commands)
+- Phase 7: Desktop UI (PySide6, 6 tabs, dark theme)
+- Phase 8: VS Code extension (TypeScript, tree view, commands, diagnostics, status bar)
+- Phase 9: Packaging (pip-installable), CI/CD (GitHub Actions), Docker, documentation

ros2_gpt-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Contributing to ROS2-GPT
+
+## Development Setup
+
+```bash
+git clone https://github.com/ros2-gpt/ros2-gpt.git
+cd ros2-gpt
+pip install -e ".[all]"
+```
+
+## Code Style
+
+- Python 3.11+ with type hints on all public APIs
+- Run `ruff check .` before committing
+- Run `mypy ros2_gpt` for static type checking
+
+## Testing
+
+- All tests in `tests/` directory
+- Run `pytest -v` to run all tests
+- Run `pytest --cov=ros2_gpt` for coverage report
+- Tests must not require external services (mock where needed)
+- New features require corresponding tests
+
+## Project Structure
+
+- `ros2_gpt/` — core Python package, submodules by concern
+- `tests/` — test suite mirroring `ros2_gpt/` structure
+- `vscode-extension/` — separate TypeScript VS Code extension
+
+## Pull Request Process
+
+1. Run lint and tests locally: `make lint typecheck test`
+2. Update documentation if adding/changing public APIs
+3. PRs require passing CI (lint + test matrix)
+4. Keep PRs focused on a single concern

ros2_gpt-0.1.0/Dockerfile

@@ -0,0 +1,12 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+COPY pyproject.toml README.md ./
+COPY ros2_gpt/ ros2_gpt/
+
+RUN pip install --no-cache-dir -e ".[server]"
+
+EXPOSE 8420
+
+CMD ["python", "-m", "ros2_gpt.api.server"]

ros2_gpt-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ROS2-GPT Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ros2_gpt-0.1.0/Makefile

@@ -0,0 +1,35 @@
+.PHONY: install install-dev lint typecheck test test-cov clean build
+
+install:
+	pip install -e .
+
+install-dev:
+	pip install -e ".[all]"
+
+lint:
+	ruff check ros2_gpt tests
+
+typecheck:
+	mypy ros2_gpt --ignore-missing-imports
+
+test:
+	pytest -v
+
+test-cov:
+	pytest --cov=ros2_gpt --cov-report=term --cov-report=html
+
+build:
+	pip install build
+	python -m build
+
+clean:
+	rm -rf dist/ build/ *.egg-info .pytest_cache __pycache__
+	find . -name '*.pyc' -delete
+	find . -name '__pycache__' -type d -exec rm -rf {} + 2>/dev/null || true
+
+.PHONY: vscode-install vscode-compile
+vscode-install:
+	cd vscode-extension && npm install
+
+vscode-compile:
+	cd vscode-extension && npm run compile

ros2_gpt-0.1.0/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: ros2-gpt
+Version: 0.1.0
+Summary: AI-powered ROS 2 development assistant
+Project-URL: Homepage, https://github.com/ros2-gpt/ros2-gpt
+Project-URL: Documentation, https://ros2-gpt.readthedocs.io
+Project-URL: Repository, https://github.com/ros2-gpt/ros2-gpt
+Project-URL: Issues, https://github.com/ros2-gpt/ros2-gpt/issues
+Author: ROS2-GPT Team
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,development,llm,robotics,ros2
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Compilers
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Requires-Dist: aiofiles>=23.2.1
+Requires-Dist: asyncio-throttle>=1.0.2
+Requires-Dist: click>=8.1.7
+Requires-Dist: httpx>=0.26.0
+Requires-Dist: lxml>=5.1.0
+Requires-Dist: networkx>=3.2.1
+Requires-Dist: numpy>=1.26.2
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: rich>=13.7.0
+Requires-Dist: tiktoken>=0.5.2
+Requires-Dist: tomli>=2.0.1; python_version < '3.11'
+Requires-Dist: watchdog>=3.0.0
+Provides-Extra: ai
+Requires-Dist: chromadb>=0.4.22; extra == 'ai'
+Requires-Dist: ollama>=0.1.7; extra == 'ai'
+Requires-Dist: openai>=1.12.0; extra == 'ai'
+Requires-Dist: sentence-transformers>=2.2.2; extra == 'ai'
+Provides-Extra: all
+Requires-Dist: chromadb>=0.4.22; extra == 'all'
+Requires-Dist: fastapi>=0.109.0; extra == 'all'
+Requires-Dist: mypy>=1.8.0; extra == 'all'
+Requires-Dist: ollama>=0.1.7; extra == 'all'
+Requires-Dist: openai>=1.12.0; extra == 'all'
+Requires-Dist: pre-commit>=3.6.0; extra == 'all'
+Requires-Dist: pyside6>=6.6.1; extra == 'all'
+Requires-Dist: pytest-asyncio>=0.23.3; extra == 'all'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'all'
+Requires-Dist: pytest>=7.4.4; extra == 'all'
+Requires-Dist: ruff>=0.2.0; extra == 'all'
+Requires-Dist: sentence-transformers>=2.2.2; extra == 'all'
+Requires-Dist: uvicorn[standard]>=0.27.0; extra == 'all'
+Requires-Dist: websockets>=12.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.6.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.3; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.4; extra == 'dev'
+Requires-Dist: ruff>=0.2.0; extra == 'dev'
+Provides-Extra: gui
+Requires-Dist: pyside6>=6.6.1; extra == 'gui'
+Provides-Extra: server
+Requires-Dist: fastapi>=0.109.0; extra == 'server'
+Requires-Dist: uvicorn[standard]>=0.27.0; extra == 'server'
+Requires-Dist: websockets>=12.0; extra == 'server'
+Description-Content-Type: text/markdown
+
+# ROS2-GPT
+
+[![CI](https://github.com/ros2-gpt/ros2-gpt/actions/workflows/ci.yml/badge.svg)](https://github.com/ros2-gpt/ros2-gpt/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+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
+
+```bash
+pip install -e ".[dev]"
+ros2-gpt scan /path/to/ros2_workspace
+```
+
+## Installation
+
+### Basic
+```bash
+pip install -e .
+```
+
+### With all extras
+```bash
+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
+```bash
+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
+```bash
+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
+
+```bash
+# 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
+
+```bash
+python -m ros2_gpt.ui
+```
+
+## VS Code Extension
+
+See [vscode-extension/](vscode-extension/README.md) for setup instructions.
+
+## Development
+
+```bash
+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

ros2_gpt-0.1.0/README.md

@@ -0,0 +1,135 @@
+# ROS2-GPT
+
+[![CI](https://github.com/ros2-gpt/ros2-gpt/actions/workflows/ci.yml/badge.svg)](https://github.com/ros2-gpt/ros2-gpt/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+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
+
+```bash
+pip install -e ".[dev]"
+ros2-gpt scan /path/to/ros2_workspace
+```
+
+## Installation
+
+### Basic
+```bash
+pip install -e .
+```
+
+### With all extras
+```bash
+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
+```bash
+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
+```bash
+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
+
+```bash
+# 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
+
+```bash
+python -m ros2_gpt.ui
+```
+
+## VS Code Extension
+
+See [vscode-extension/](vscode-extension/README.md) for setup instructions.
+
+## Development
+
+```bash
+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