syswonder/robonix

Robonix – 구현된 AI를 위한 에이전트 운영 체제

개요 – Robonix는 자연어 명령으로 다양한 로봇을 제어할 수 있는 오픈 소스 범용 운영 체제입니다. 대규모 언어/시각 언어 모델(LLMs/VLMs)과 로봇 하드웨어 사이에 위치하여 사용자의 요청을 로봇이 실행하는 Robot Task Description Language (RTDL) 프로그램으로 변환합니다.

중요성 – 계층적 추상화(프리미티브 → 서비스 → 스킬 → 작업)를 통해 하드웨어와 소프트웨어를 분리함으로써, 동일한 상위 수준 코드를 바퀴형 베이스, 사족 보행, 팔, 손, 또는 시뮬레이션 아바타에서 실행할 수 있습니다. 이를 통해 플랫폼 간의 인식, 계획 및 조작 기능을 훨씬 쉽게 재사용할 수 있으며, LLM이 로봇별 계획을 즉석에서 생성할 수 있게 합니다.

핵심 개념 및 아키텍처

레이어	역할
Primitive	버전이 지정된 인터페이스를 통해 노출되는 직접적인 하드웨어 I/O(센서, 액추에이터).
Service	Robonix 인터페이스를 구현하는 재사용 가능한 소프트웨어(예: SLAM, 내비게이션, 객체 감지).
Skill	실행 가능한 단위로 패키징된 학습 모델 또는 알고리즘(예: 픽 앤 플레이스, 붓기, VLA 모델).
Task	제약 조건과 성공 기준이 있는 사용자 수준의 목표.

이 시스템은 몇 가지 핵심 구성 요소를 중심으로 구축되었습니다(README의 아키텍처 다이어그램 참조):

Liaison – Keystone을 통해 사용자를 인증하고 자연어 요청을 수신하는 프런트엔드.
Pilot – LLM/VLM에게 요청된 작업에 대한 RTDL 프로그램을 작성하도록 하고, 이를 검증한 후 Executor로 전달하는 오케스트레이터.
Executor – 로봇에서 RTDL 프로그램을 실행.
Sentinel – 안전 및 상태를 위해 실행을 모니터링.
Scene – 객체의 의미론적 지도와 환경의 공간 지도를 유지.
Atlas, Nexus, Chronos, Scribe, Vitals – 서비스 검색, 메시징, 타이밍, 로깅 및 상태 확인 인프라 제공.
Soma – 로봇의 기하학적 구조와 제공하는 프리미티브를 설명하는 본체 추상화(URDF + YAML).

모든 구성 요소는 Atlas에 버전이 지정된 계약을 등록하므로 호출자는 구체적인 구현이 아닌 계약에 바인딩됩니다. 이를 통해 상위 수준 코드를 변경하지 않고도 스킬이나 서비스를 교체하거나, 작업을 한 로봇 본체에서 다른 로봇 본체로 이동할 수 있습니다.

시작하기(README에서)

필수 구성 요소 설치 – Rust, Python 도구 uv, Docker(Webots 시뮬레이터용), NVIDIA Container Toolkit(NVIDIA GPU가 있는 경우), 표준 빌드 도구(build-essential, pkg-config, OpenSSL 헤더, ALSA utils).

복제 및 빌드

git clone --recursive https://github.com/syswonder/robonix.git
cd robonix
make install   # Rust 구성 요소 및 `rbnx` CLI 빌드

시뮬레이터 실행(Webots 예시), 한 터미널에서:
```
export DISPLAY=:0
bash examples/webots/sim/start.sh
```

Robonix 시작, 다른 터미널에서 OpenAI 호환 VLM 엔드포인트를 지정:

export RMW_IMPLEMENTATION=rmw_zenoh_cpp
export VLM_BASE_URL=https://api.openai.com/v1
export VLM_API_KEY=sk-…
export VLM_MODEL=your-model-name
cd examples/webots
rbnx build && rbnx boot

로봇과 대화 – 세 번째 터미널을 열고 rbnx chat을 실행합니다. go to room 101, what can you see?, explore the office와 같은 명령을 시도해 보세요.

개발자를 위해 Robonix 패키지 템플릿(template-rbnx)은 로봇 하드웨어 없이도 빌드하고 실행할 수 있는 모의 프리미티브, 서비스 및 스킬을 제공합니다. rbnx caps를 사용하여 라이브 기능 제공자를 나열하고 rbnx chat을 사용하여 상호 작용할 수 있습니다.

지원되는 로봇 및 생태계

Robonix는 즉시 사용 가능한 로봇 매니페스트를 나열하는 패키지 카탈로그(https://packages.robonix.ai)를 제공합니다. README에는 다음을 포함하여 수십 개의 실제 및 시뮬레이션 플랫폼이 나와 있습니다:

AgileX Ranger Mini v3, DEEP Robotics Lite3 & Lynx S10, Unitree Go2, Yobotics Y20W, MirrorMe BPX, Wheeltec R550, Yahboom ROSMASTER X3, Hantewin Benben, BeingBeyond D1, AUBO i5H, LinkerHand O6 등.
Webots TIAGo Lite, Minecraft Bot, MuJoCo 기반 Ranger+Piper, Unitree Go2와 같은 시뮬레이션 본체.

각 로봇 항목은 하드웨어 드라이버가 포함된 저장소와 프리미티브, 서비스, 스킬을 자세히 설명하는 카탈로그 페이지로 연결됩니다. 모든 로봇이 동일한 Robonix 계약을 노출하므로 동일한 상위 수준 RTDL 프로그램을 어떤 로봇에서든 실행할 수 있습니다.

라이선스

이 프로젝트는 Mulan PSL-2.0 라이선스에 따라 릴리스됩니다(README의 배지 참조).

결론 – Robonix는 LLM이 실행 가능한 로봇 프로그램을 생성하고, 하드웨어 차이를 추상화하며, 로봇별 패키지 라이브러리를 확장할 수 있는 모듈식 계약 기반 스택을 제공합니다. 자연어로 지시하고 실행 전에 검증할 수 있는 "에이전트" 로봇을 구축하려는 연구 및 제품 팀을 위한 기반으로 자리 잡고 있습니다.