Repolode
Enviar
fujitatomoya

fujitatomoya/ros2ai

Extensión de línea de comandos de ROS 2 para consultar, explorar y ejecutar comandos en lenguaje natural con LLM de OpenAI u Ollama.

Ver en GitHubSitio web
Estrellas
335
Forks
27
Issues abiertos
7
Último commit
ayer

¿Qué es?

ros2ai añade un subcomando con IA a la línea de comandos de ROS 2, para que los desarrolladores puedan hacer preguntas sobre ROS 2 o enviar solicitudes en lenguaje natural, sin tener que buscar la sintaxis exacta de la CLI. Está pensado para principiantes y estudiantes que aún no conocen ros2cli.

La herramienta ofrece tres modos principales: status comprueba si la clave de API o el endpoint configurados son válidos; query responde preguntas y sugiere comandos; y exec ejecuta el comando de ROS 2 adecuado para una solicitud, como listar nodos o mostrar detalles de un topic. También se pueden hacer preguntas en otros idiomas además del inglés.

El backend usa la API de Python de OpenAI, que también puede comunicarse con un servidor local de Ollama que ofrece un endpoint compatible con OpenAI. El modelo, el endpoint y la temperatura se configuran mediante variables de entorno. Se puede instalar como paquete Debian o ejecutar en Docker, y es compatible con las distribuciones de ROS 2 Humble, Jazzy, Kilted y Rolling.

Funciones clave

  • 01Responde preguntas sobre ROS 2 y sugiere el comando ros2 correspondiente.
  • 02Ejecuta solicitudes en lenguaje natural, como listar nodos o mostrar detalles de un topic.
  • 03Funciona con modelos de OpenAI o con un servidor local de Ollama mediante un endpoint compatible con OpenAI.
  • 04Permite configurar el modelo, el endpoint y la temperatura mediante variables de entorno.
  • 05Está disponible como paquete Debian o imagen de Docker, y se puede compilar con colcon.

Casos de uso

  • Aprender comandos de la CLI de ROS 2 como principiante o estudiante.
  • Encontrar rápidamente el comando ros2 adecuado para una tarea sin consultar la documentación.
  • Ejecutar un modelo local de Ollama para consultar un sistema ROS 2 sin enviar solicitudes a una API en la nube.

Inicio rápido

  1. 1

    Instala el paquete binario para ROS 2 Kilted

    apt install ros-kilted-ros2ai
  2. 2

    Instala los paquetes de Python necesarios (rolling, kilted, jazzy)

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

    Configura tu clave de API de OpenAI o configura Ollama y descarga un modelo

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

Antes de usarlo

  • Se requiere una clave de API de OpenAI o un servicio de Ollama en ejecución con un modelo descargado.
  • No hay un paquete publicado disponible para algunas configuraciones; es necesario compilar desde el código fuente en un espacio de trabajo de colcon.
  • Solo se admiten las distribuciones ROS 2 Humble, Jazzy, Kilted y Rolling.

En colecciones

Ejecuta LLM en localProyectos de robótica e IA encarnada

Temas

#ros2#robotics#llm#command-line#openai#ollama

Preguntas frecuentes

¿Qué es ros2ai?
Extensión de línea de comandos de ROS 2 para consultar, explorar y ejecutar comandos en lenguaje natural con LLM de OpenAI u Ollama. ros2ai añade un subcomando con IA a la línea de comandos de ROS 2, para que los desarrolladores puedan hacer preguntas sobre ROS 2 o enviar solicitudes en lenguaje natural, sin tener que buscar la sintaxis exacta de la CLI. Está pensado para principiantes y estudiantes que aún no conocen ros2cli.
¿ros2ai es gratuito? ¿Qué licencia tiene?
ros2ai es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ros2ai sigue mantenido?
Mantenimiento activo. El último commit de ros2ai fue el 6 nov 2026.
¿Para qué puedo usar ros2ai?
Aprender comandos de la CLI de ROS 2 como principiante o estudiante. Encontrar rápidamente el comando ros2 adecuado para una tarea sin consultar la documentación. Ejecutar un modelo local de Ollama para consultar un sistema ROS 2 sin enviar solicitudes a una API en la nube.
¿Cómo se instala ros2ai?
Instala el paquete binario para ROS 2 Kilted: apt install ros-kilted-ros2ai Instala los paquetes de Python necesarios (rolling, kilted, jazzy): pip install openai ollama validators --break-system-packages --ignore-installed Configura tu clave de API de OpenAI o configura Ollama y descarga un modelo: export OPENAI_API_KEY='your-api-key-here'
¿Dónde consigo ros2ai?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/fujitatomoya/ros2ai

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados