How nssmd/roborsi works
RoboRSI is a multi-agent harness for robot self-evolution. Its principal workflow turns a user task into a Manager-led plan, Engineer execution through robot tools, and independent review; failures can lead to gated skill changes, while successful workflows can be consolidated or used for policy learning. The repository also includes frozen evaluation, dataset curation, chat channels, and web cockpit capabilities. The graph combines README-documented workflow with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled implementation links are omitted where evidence is insufficient.
Main entry points: engineer.py Engineer · rollout.py Agent rollout · App.tsx Web cockpit · manager_chat.py Manager
Components 28
Task roles
- Manager
roborsi/agents/manager_chat.py - Planner
roborsi/agents/planner.py - Engineer
roborsi/agents/engineer.py - Reviewer
roborsi/agents/reviewer.py - Role sessions
roborsi/agents/persistent_agent.py
Robot execution
- Agent rollout
roborsi/embodied/agent_loop/rollout.py - Prompt tools
roborsi/embodied/agent_loop/prompt_tools.py - Robot skills
roborsi/embodied/skills/__init__.py - Robot environment
roborsi/embodied/agent_loop/env.py - Vision-language I/O
roborsi/embodied/agent_loop/vlm_io.py
Evolution and learning
- Task-skill tree
roborsi/agent/lifecycle/scaffold.py - Task workspace
roborsi/agents/workspace.py - Skill proposals
roborsi/agents/proposal_safety.py - Policy learning
roborsi/learning/auto_apply.py - Dataset curation
roborsi/data/curation/service.py - Frozen evaluation
roborsi/evaluation/suite.py
User interfaces
- Web cockpit service
roborsi/embodied/board/web/server.py - Web cockpit
frontend/web/src/App.tsx - Web data hooks
frontend/web/src/lib/hooks.ts - Display formatting
frontend/web/src/lib/format.ts - UI primitives
frontend/web/src/components/primitives.tsx
Platform services
- Run mode
roborsi/runtime_mode.py - Model providers
roborsi/providers/registry.py - Chat channels
roborsi/channels/manager.py - Channel interface
roborsi/channels/base.py - Channel agent
roborsi/channels/core/agent.py - Trace database
roborsi/store/trace_db.py
Other components
- Task requester
Connections 25
- Task requester → Manager: submits task
README.md - Manager → Planner: decomposes tasks
README.md - Planner → Engineer: provides plan
README.md - Engineer → Agent rollout: runs episode
roborsi/agents/engineer.py - Agent rollout → Prompt tools: dispatches tools
roborsi/embodied/agent_loop/rollout.py - Agent rollout → Robot environment: acts in
roborsi/embodied/agent_loop/rollout.py - Agent rollout → Vision-language I/O: uses model I/O
roborsi/embodied/agent_loop/rollout.py - Prompt tools → Robot skills: exposes skills
README.md - Engineer → Reviewer: submits trace
README.md - Reviewer → Skill proposals: proposes revision
README.md - Reviewer → Task-skill tree: locates failure
README.md - Skill proposals → Manager: requests gate
README.md - Engineer → Task workspace: records outcome
roborsi/agents/engineer.py - Engineer → Trace database: records execution
- Engineer → Policy learning: supplies experience
README.md - Policy learning → Dataset curation: prepares training data
- Frozen evaluation → Run mode: freezes mutations
roborsi/runtime_mode.py - Role sessions → Channel agent: uses channel agent
roborsi/agents/persistent_agent.py - Chat channels → Channel interface: initializes channels
roborsi/channels/manager.py - Manager → Role sessions: uses sessions
roborsi/agents/manager_chat.py - Agent rollout → Model providers: selects model
- Web cockpit service → Web cockpit: serves cockpit
- Web cockpit → Web data hooks: reads data
frontend/web/src/App.tsx - Web cockpit → Display formatting: formats views
- Web cockpit → UI primitives: renders controls