https://github.com/syswonder/robonix
embodied AI operating system (EAIOS)
https://github.com/syswonder/robonix
agent embodied-ai linux operating-system robotics ros2 skill-md
Last synced: about 2 months ago
JSON representation
embodied AI operating system (EAIOS)
- Host: GitHub
- URL: https://github.com/syswonder/robonix
- Owner: syswonder
- License: mulanpsl-2.0
- Created: 2025-09-25T05:44:36.000Z (9 months ago)
- Default Branch: dev
- Last Pushed: 2026-04-24T04:31:27.000Z (about 2 months ago)
- Last Synced: 2026-04-24T06:23:33.480Z (about 2 months ago)
- Topics: agent, embodied-ai, linux, operating-system, robotics, ros2, skill-md
- Language: Rust
- Homepage: http://robonix.syswonder.org
- Size: 190 MB
- Stars: 21
- Watchers: 2
- Forks: 15
- Open Issues: 6
-
Metadata Files:
- Readme: README-zh.md
- License: LICENSE
Awesome Lists containing this project
README
Robonix — 具身智能操作系统
Rust 原生 EAIOS。以 skill 为中心的运行时：Liaison / Pilot / Atlas / Nexus / Executor —— 从人的意图到具身动作一条链路打通。
English ·
手册 (mdBook) ·
Rust workspace ·
示例与端到端
## 快速上手
```bash
git clone --recursive https://github.com/syswonder/robonix
cd robonix/rust
make install # → ~/.cargo/bin (rbnx, robonix-atlas, …)
pip install -r examples/requirements.txt
cp examples/.env.example examples/.env # 填 VLM_API_KEY + VLM_BASE_URL + VLM_MODEL
./examples/run.sh # atlas + vlm + tiago sim + pilot + …
```
在另一个终端跟 agent 对话：
```bash
rbnx chat
```
完整首次运行指引见 [**docs/src/getting-started/quickstart.md**](https://github.com/syswonder/robonix-book/blob/main/src/getting-started/quickstart.md)。
## 仓库概览
| | |
|---|---|
| [`rust/`](rust/) | Cargo 工作区 —— atlas / pilot / executor / liaison / cli / codegen / sdk / interfaces / buffer |
| [`rust/contracts/`](rust/contracts/) | 稳定 `contract_id` 定义（TOML），对应 `rust/crates/robonix-interfaces/lib/` 下的 ROS IDL |
| [`rust/examples/packages/`](rust/examples/packages/) | 示例包：`vlm_service`、`memsearch_service`、`tiago_sim_stack`、`maniskill_vla_demo`、`zero_copy_demo`、`clawhub_skills` |
| [`docs/`](https://github.com/syswonder/robonix-book) | mdBook —— 架构、接口目录、接入指南 |
| [`images/`](images/) | Logo 与 demo 资产 |
## 30 秒架构
EAIOS 四层抽象：**原语 (primitive) → 服务 (service) → 技能 (skill) → 任务 (task)**。统一控制面（Atlas）负责注册、发现、通道协商，跨多种 transport 工作（gRPC / MCP / ROS 2 / 共享内存）。Agent 推理由 Pilot 负责（VLM + ReAct + TaskGraph），工具分发由 Executor 负责，用户交互由 Liaison 负责。
深入阅读：
- [**系统全景**](https://github.com/syswonder/robonix-book/blob/main/src/architecture/overview.md) —— 控制面/数据面、一次请求的完整链路
- [**Crate 索引**](https://github.com/syswonder/robonix-book/blob/main/src/architecture/crates.md) —— 各可执行文件职责与端口
- [**命名空间与接口模型**](https://github.com/syswonder/robonix-book/blob/main/src/architecture/namespace-and-interfaces.md) —— `robonix/prm/*` 与 `robonix/srv/*` 怎么组织
- [**接口目录**](https://github.com/syswonder/robonix-book/blob/main/src/interface-catalog/index.md) —— 每个 primitive + service 契约
## Agent Skills（agentskills.io）
Robonix 可摄入 [**Agent Skills**](https://agentskills.io/) 开放标准 —— 与 Claude Code、Cursor、GitHub Copilot、OpenCode、Gemini CLI、OpenClaw 等 30+ 个 AI 工具共用的 `SKILL.md` + frontmatter 格式。把 skill 文件放到 `~/.robonix/skills//`（或 `ROBONIX_SKILLS_EXTRA_DIRS` 指定目录），Pilot 启动时自动加载。
> **概念区分**：这里的 "Agent Skill" 指的是 **Agent 上下文里的说明书**——一份 Markdown 文件，告诉 LLM 如何使用一组工具。它与 Robonix 白皮书里的**技能层**不是一回事——白皮书的"技能"指部署到系统上的可执行行为单元（基本技能 = 预训练 VLA/RL 进程；RTDL 技能 = 运行时生成的结构化方案）。两者只是同名，处于不同抽象层。详见 [**docs/src/skill-library.md**](https://github.com/syswonder/robonix-book/blob/main/src/skill-library.md)；Agent Skills 只是注入到 VLM prompt 的 `SkillInfo` 的其中一种来源。
> 早期 `rbnx start` 会自动扫描包内 `/skills/` 并注册到 Atlas，这一机制**已取消**——包与 skill 现在完全解耦。详见 `skill-library.md` 中的迁移说明。
## `rbnx` CLI
完整命令 `rbnx --help`。常用的：
```bash
rbnx setup # 登记当前 clone 为源码根，让任意位置的包都能定位 contracts/IDL
rbnx build -p # 跑包的 build.sh（codegen + 其他）
rbnx codegen -p # 只做 codegen（proto + Python stubs）
rbnx start -p -n
rbnx chat # TUI → Pilot → Executor
rbnx nodes / tools / channels / inspect / graph
```
包作者请看 [**Build 与 Codegen**](https://github.com/syswonder/robonix-book/blob/main/src/integration-guide/build-and-codegen.md)。
## 项目状态
> [!WARNING]
> 处于快速迭代的早期阶段。接口、IDL 布局、内部设计可能在没有预警的情况下变更。在发布正式版本之前不保证 API 稳定性。
已可用：Atlas 控制面、Pilot/Executor ReAct 循环、SKILL.md 发现、`rbnx` 包流程（`validate` / `build` / `codegen` / `start` / `install`）、Tiago Webots E2E、ManiSkill3 VLA demo。
进行中：系统服务的正式部署机制（当前仍以 example package 承载）、TaskGraph 超越线性编码、服务端的 catalog 强校验、产品级 Liaison。
## 参与贡献
从 `dev` 分支拉取，`make fmt`、`make check`、提 PR。若有 `CONTRIBUTING.md` 请参考。
## 许可证
Mulan Permissive Software License, Version 2 (MulanPSL-2.0)。详见 [LICENSE](LICENSE)。