{"id":49318025,"url":"https://github.com/syswonder/robonix","last_synced_at":"2026-04-26T16:04:51.276Z","repository":{"id":316535903,"uuid":"1063782606","full_name":"syswonder/robonix","owner":"syswonder","description":"embodied AI operating system (EAIOS)","archived":false,"fork":false,"pushed_at":"2026-04-24T04:31:27.000Z","size":198989,"stargazers_count":21,"open_issues_count":6,"forks_count":15,"subscribers_count":2,"default_branch":"dev","last_synced_at":"2026-04-24T06:23:33.480Z","etag":null,"topics":["agent","embodied-ai","linux","operating-system","robotics","ros2","skill-md"],"latest_commit_sha":null,"homepage":"http://robonix.syswonder.org","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mulanpsl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/syswonder.png","metadata":{"files":{"readme":"README-zh.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-25T05:44:36.000Z","updated_at":"2026-04-22T00:50:08.000Z","dependencies_parsed_at":"2025-10-25T17:23:50.279Z","dependency_job_id":null,"html_url":"https://github.com/syswonder/robonix","commit_stats":null,"previous_names":["syswonder/robonix"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/syswonder/robonix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syswonder%2Frobonix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syswonder%2Frobonix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syswonder%2Frobonix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syswonder%2Frobonix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/syswonder","download_url":"https://codeload.github.com/syswonder/robonix/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syswonder%2Frobonix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32303179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","embodied-ai","linux","operating-system","robotics","ros2","skill-md"],"created_at":"2026-04-26T16:04:49.326Z","updated_at":"2026-04-26T16:04:51.268Z","avatar_url":"https://github.com/syswonder.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/robonix-logo.svg\" alt=\"Robonix\" width=\"420\" /\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003eRobonix — 具身智能操作系统\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eRust 原生 EAIOS。以 skill 为中心的运行时：Liaison / Pilot / Atlas / Nexus / Executor —— 从人的意图到具身动作一条链路打通。\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/syswonder/robonix/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MulanPSL--2.0-red?style=flat-square\" alt=\"License\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/syswonder/robonix/graphs/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/syswonder/robonix?color=blue\u0026style=flat-square\" alt=\"Contributors\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/github/languages/code-size/syswonder/robonix?color=green\u0026style=flat-square\" alt=\"Code size\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/repo-size/syswonder/robonix?color=lightgray\u0026style=flat-square\" alt=\"Repo size\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/languages/top/syswonder/robonix?color=orange\u0026style=flat-square\" alt=\"Top language\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"README.md\"\u003eEnglish\u003c/a\u003e ·\n  \u003ca href=\"docs/\"\u003e手册 (mdBook)\u003c/a\u003e ·\n  \u003ca href=\"rust/README.md\"\u003eRust workspace\u003c/a\u003e ·\n  \u003ca href=\"rust/examples/README.md\"\u003e示例与端到端\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr /\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/demo_01_readme.gif\" alt=\"Robonix demo\" width=\"920\" /\u003e\n\u003c/p\u003e\n\n## 快速上手\n\n```bash\ngit clone --recursive https://github.com/syswonder/robonix\ncd robonix/rust\nmake install                              # → ~/.cargo/bin (rbnx, robonix-atlas, …)\npip install -r examples/requirements.txt\ncp examples/.env.example examples/.env    # 填 VLM_API_KEY + VLM_BASE_URL + VLM_MODEL\n./examples/run.sh                         # atlas + vlm + tiago sim + pilot + …\n```\n\n在另一个终端跟 agent 对话：\n\n```bash\nrbnx chat\n```\n\n完整首次运行指引见 [**docs/src/getting-started/quickstart.md**](https://github.com/syswonder/robonix-book/blob/main/src/getting-started/quickstart.md)。\n\n## 仓库概览\n\n| | |\n|---|---|\n| [`rust/`](rust/) | Cargo 工作区 —— atlas / pilot / executor / liaison / cli / codegen / sdk / interfaces / buffer |\n| [`rust/contracts/`](rust/contracts/) | 稳定 `contract_id` 定义（TOML），对应 `rust/crates/robonix-interfaces/lib/` 下的 ROS IDL |\n| [`rust/examples/packages/`](rust/examples/packages/) | 示例包：`vlm_service`、`memsearch_service`、`tiago_sim_stack`、`maniskill_vla_demo`、`zero_copy_demo`、`clawhub_skills` |\n| [`docs/`](https://github.com/syswonder/robonix-book) | mdBook —— 架构、接口目录、接入指南 |\n| [`images/`](images/) | Logo 与 demo 资产 |\n\n## 30 秒架构\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/robonix-layers.png\" alt=\"Robonix 分层架构\" width=\"580\" /\u003e\n\u003c/p\u003e\n\nEAIOS 四层抽象：**原语 (primitive) → 服务 (service) → 技能 (skill) → 任务 (task)**。统一控制面（Atlas）负责注册、发现、通道协商，跨多种 transport 工作（gRPC / MCP / ROS 2 / 共享内存）。Agent 推理由 Pilot 负责（VLM + ReAct + TaskGraph），工具分发由 Executor 负责，用户交互由 Liaison 负责。\n\n深入阅读：\n- [**系统全景**](https://github.com/syswonder/robonix-book/blob/main/src/architecture/overview.md) —— 控制面/数据面、一次请求的完整链路\n- [**Crate 索引**](https://github.com/syswonder/robonix-book/blob/main/src/architecture/crates.md) —— 各可执行文件职责与端口\n- [**命名空间与接口模型**](https://github.com/syswonder/robonix-book/blob/main/src/architecture/namespace-and-interfaces.md) —— `robonix/prm/*` 与 `robonix/srv/*` 怎么组织\n- [**接口目录**](https://github.com/syswonder/robonix-book/blob/main/src/interface-catalog/index.md) —— 每个 primitive + service 契约\n\n## Agent Skills（agentskills.io）\n\nRobonix 可摄入 [**Agent Skills**](https://agentskills.io/) 开放标准 —— 与 Claude Code、Cursor、GitHub Copilot、OpenCode、Gemini CLI、OpenClaw 等 30+ 个 AI 工具共用的 `SKILL.md` + frontmatter 格式。把 skill 文件放到 `~/.robonix/skills/\u003cname\u003e/`（或 `ROBONIX_SKILLS_EXTRA_DIRS` 指定目录），Pilot 启动时自动加载。\n\n\u003e **概念区分**：这里的 \"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` 的其中一种来源。\n\n\u003e 早期 `rbnx start` 会自动扫描包内 `\u003cpackage\u003e/skills/` 并注册到 Atlas，这一机制**已取消**——包与 skill 现在完全解耦。详见 `skill-library.md` 中的迁移说明。\n\n## `rbnx` CLI\n\n完整命令 `rbnx --help`。常用的：\n\n```bash\nrbnx setup                # 登记当前 clone 为源码根，让任意位置的包都能定位 contracts/IDL\nrbnx build -p \u003cpkg\u003e       # 跑包的 build.sh（codegen + 其他）\nrbnx codegen -p \u003cpkg\u003e     # 只做 codegen（proto + Python stubs）\nrbnx start -p \u003cpkg\u003e -n \u003cnode\u003e\nrbnx chat                 # TUI → Pilot → Executor\nrbnx nodes / tools / channels / inspect / graph\n```\n\n包作者请看 [**Build 与 Codegen**](https://github.com/syswonder/robonix-book/blob/main/src/integration-guide/build-and-codegen.md)。\n\n## 项目状态\n\n\u003e [!WARNING]\n\u003e 处于快速迭代的早期阶段。接口、IDL 布局、内部设计可能在没有预警的情况下变更。在发布正式版本之前不保证 API 稳定性。\n\n已可用：Atlas 控制面、Pilot/Executor ReAct 循环、SKILL.md 发现、`rbnx` 包流程（`validate` / `build` / `codegen` / `start` / `install`）、Tiago Webots E2E、ManiSkill3 VLA demo。\n\n进行中：系统服务的正式部署机制（当前仍以 example package 承载）、TaskGraph 超越线性编码、服务端的 catalog 强校验、产品级 Liaison。\n\n## 参与贡献\n\n从 `dev` 分支拉取，`make fmt`、`make check`、提 PR。若有 `CONTRIBUTING.md` 请参考。\n\n## 许可证\n\nMulan Permissive Software License, Version 2 (MulanPSL-2.0)。详见 [LICENSE](LICENSE)。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyswonder%2Frobonix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsyswonder%2Frobonix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyswonder%2Frobonix/lists"}