fujitatomoya/ros2ai

어떤 프로젝트인가요?

핵심 기능

• 01ROS 2 관련 질문에 답하고 이에 맞는 ros2 명령을 제안합니다.
• 02노드 목록 조회나 토픽 세부 정보 확인 같은 자연어 요청을 실행합니다.
• 03OpenAI 호환 엔드포인트를 통해 OpenAI 모델이나 로컬 Ollama 서버를 사용할 수 있습니다.
• 04환경 변수로 모델, 엔드포인트, temperature를 설정할 수 있습니다.
• 05Debian 패키지나 Docker 이미지로 이용할 수 있으며, colcon으로 빌드할 수 있습니다.

활용 사례

• 초보자나 학생이 ROS 2 CLI 명령을 익힐 때 활용합니다.
• 문서를 찾아보지 않고 작업에 맞는 ros2 명령을 빠르게 확인합니다.
• 로컬 Ollama 모델을 사용해 클라우드 API로 요청을 보내지 않고 ROS 2 시스템에 질의합니다.

빠른 시작

1. 1

   ROS 2 Kilted용 바이너리 패키지를 설치합니다

   apt install ros-kilted-ros2ai
2. 2

   필수 Python 패키지(rolling, kilted, jazzy)를 설치합니다

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

   OpenAI API 키를 설정하거나 Ollama를 설정하고 모델을 pull합니다

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

사용 전 알아둘 점

• !OpenAI API 키 또는 모델을 다운로드한 Ollama 서비스가 실행 중이어야 합니다.
• !일부 환경에서는 릴리스된 패키지를 사용할 수 없으므로 colcon 워크스페이스에서 소스 코드를 빌드해야 합니다.
• !ROS 2 Humble, Jazzy, Kilted, Rolling 배포판만 지원합니다.

포함된 컬렉션

토픽

자주 묻는 질문

ros2ai은(는) 무엇인가요?

OpenAI 또는 Ollama LLM을 사용해 자연어로 ROS 2 명령을 조회하고 살펴보거나 실행할 수 있는 ROS 2 CLI 확장입니다. ros2ai는 ROS 2 명령줄에 AI 기반 하위 명령을 추가해, 개발자가 정확한 CLI 문법을 찾아보는 대신 자연어로 ROS 2에 관해 질문하거나 작업을 요청할 수 있게 합니다. ros2cli에 아직 익숙하지 않은 초보자와 학생을 대상으로 합니다.

ros2ai은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ros2ai은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ros2ai은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ros2ai의 마지막 커밋은 2026년 11월 6일입니다.

ros2ai은(는) 어디에 사용할 수 있나요?

초보자나 학생이 ROS 2 CLI 명령을 익힐 때 활용합니다. 문서를 찾아보지 않고 작업에 맞는 ros2 명령을 빠르게 확인합니다. 로컬 Ollama 모델을 사용해 클라우드 API로 요청을 보내지 않고 ROS 2 시스템에 질의합니다.

ros2ai는 어떻게 설치하나요?

ROS 2 Kilted용 바이너리 패키지를 설치합니다: apt install ros-kilted-ros2ai 필수 Python 패키지(rolling, kilted, jazzy)를 설치합니다: pip install openai ollama validators --break-system-packages --ignore-installed OpenAI API 키를 설정하거나 Ollama를 설정하고 모델을 pull합니다: export OPENAI_API_KEY='your-api-key-here'

ros2ai은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/fujitatomoya/ros2ai