Repolode
Enviar
fujitatomoya

fujitatomoya/ros2ai

Uma extensão de linha de comando para ROS 2 que permite consultar, explorar e executar comandos em linguagem natural usando LLMs da OpenAI ou Ollama.

Ver no GitHubSite
Estrelas
335
Forks
27
Issues abertas
7
Último commit
há 21 horas

O que é?

ros2ai adiciona um subcomando com IA à linha de comando do ROS 2, permitindo que desenvolvedores façam perguntas sobre ROS 2 ou solicitem ações em linguagem simples, sem precisar procurar a sintaxe exata da CLI. A ferramenta é voltada a iniciantes e estudantes que ainda não conhecem o ros2cli.

A ferramenta oferece três modos principais: status verifica se a chave de API ou o endpoint configurado é válido; query responde a uma pergunta e sugere comandos; e exec executa o comando ROS 2 adequado para uma solicitação, como listar nós ou exibir detalhes de um tópico. Também é possível fazer perguntas em outros idiomas além do inglês.

O backend usa a API Python da OpenAI, que também pode se conectar a um servidor Ollama local com um endpoint compatível com a OpenAI. O modelo, o endpoint e a temperatura são definidos por variáveis de ambiente. A ferramenta pode ser instalada como pacote Debian ou executada no Docker e oferece suporte às distribuições ROS 2 Humble, Jazzy, Kilted e Rolling.

Recursos principais

  • 01Responde a perguntas sobre ROS 2 e sugere o comando ros2 correspondente.
  • 02Executa solicitações em linguagem natural, como listar nós ou exibir detalhes de tópicos.
  • 03Funciona com modelos da OpenAI ou com um servidor Ollama local por meio de um endpoint compatível com a OpenAI.
  • 04Permite configurar o modelo, o endpoint e a temperatura por variáveis de ambiente.
  • 05Disponível como pacote Debian ou imagem Docker, e pode ser compilada com colcon.

Casos de uso

  • Aprender comandos da CLI do ROS 2 como iniciante ou estudante.
  • Encontrar rapidamente o comando ros2 adequado para uma tarefa sem consultar a documentação.
  • Executar um modelo Ollama local para consultar um sistema ROS 2 sem enviar solicitações a uma API na nuvem.

Início rápido

  1. 1

    Instale o pacote binário para ROS 2 Kilted

    apt install ros-kilted-ros2ai
  2. 2

    Instale os pacotes Python necessários (rolling, kilted, jazzy)

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

    Configure sua chave de API da OpenAI ou configure o Ollama e baixe um modelo

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

Antes de usar

  • É necessário ter uma chave de API da OpenAI ou um serviço Ollama em execução com um modelo baixado.
  • Não há um pacote lançado disponível para algumas configurações; é necessário compilar a partir do código-fonte em um workspace do colcon.
  • Há suporte apenas às distribuições ROS 2 Humble, Jazzy, Kilted e Rolling.

Em coleções

Rode LLMs localmenteProjetos de robótica e IA corporificada

Tópicos

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

Perguntas frequentes

O que é ros2ai?
Uma extensão de linha de comando para ROS 2 que permite consultar, explorar e executar comandos em linguagem natural usando LLMs da OpenAI ou Ollama. ros2ai adiciona um subcomando com IA à linha de comando do ROS 2, permitindo que desenvolvedores façam perguntas sobre ROS 2 ou solicitem ações em linguagem simples, sem precisar procurar a sintaxe exata da CLI. A ferramenta é voltada a iniciantes e estudantes que ainda não conhecem o ros2cli.
ros2ai é gratuito? Qual é a licença?
ros2ai é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
ros2ai ainda é mantido?
Manutenção ativa. O último commit de ros2ai foi em 7 de nov. de 2026.
Para que posso usar ros2ai?
Aprender comandos da CLI do ROS 2 como iniciante ou estudante. Encontrar rapidamente o comando ros2 adequado para uma tarefa sem consultar a documentação. Executar um modelo Ollama local para consultar um sistema ROS 2 sem enviar solicitações a uma API na nuvem.
Como instalar ros2ai?
Instale o pacote binário para ROS 2 Kilted: apt install ros-kilted-ros2ai Instale os pacotes Python necessários (rolling, kilted, jazzy): pip install openai ollama validators --break-system-packages --ignore-installed Configure sua chave de API da OpenAI ou configure o Ollama e baixe um modelo: export OPENAI_API_KEY='your-api-key-here'
Onde consigo ros2ai?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/fujitatomoya/ros2ai

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados