Skip to main content

Mushroom Architecture

MushroomAgent is designed to be a distributed embodied agent that can perceive, think, and act in the real world.

Design goals​

  • unified subject
  • unified world model
  • unified action plane
  • unified evolution as nodes grow

System overview​

users / physical world / rtc rooms / external platforms
                  |
               channel
                  |
            communication
                  |
                sensor
                  |
                 agent
                  |
                 think
                  |
                 skill
                  |
      tools / planning / node dispatch
                  |
       node A / node B / node C / device capabilities

Core abstractions​

Channel -> Communication​

channel owns platform semantics, while communication owns unified transport and message flow.

Sensor​

sensor is the first interpretation layer that turns text, audio, video, and control events into agent-ready input.

Agent -> Think -> Skill​

  • agent owns the turn lifecycle and orchestration
  • think decides what to do next
  • skill gives think reusable procedural guidance

Nodes and capabilities​

Nodes are embodied units. The system dispatches by capabilities and current goals rather than by hard-coded node types.