Skip to content

Robotair Robots⿻

Estimated time to read: 3 minutes

Concept Overview⿻

In Robotair, a "Robot" refers to a physical or virtual entity composed of one or more compute units, each running a Robotair Agent. These agents collectively represent a single logical robot and are identified and managed as a unified unit within the Robotair platform.

Robotair does not limit a robot to a specific compute configuration. Whether it’s a simple single-board computer or a distributed set of control and perception units, Robotair can group these together under one robot identity and orchestrate them as one.

Platform Role⿻

The Robot abstraction allows the Robotair platform to apply deployments, monitor health, collect logs, and execute updates in a unified way even if the underlying robot is composed of multiple hardware nodes. This abstraction simplifies fleet operations and provides centralized insight and control.

Functional Capabilities⿻

  • Secure onboarding using a token-based installation process
  • Ability to associate one or more agents with the same robot identity
  • Automatic aggregation of metrics, logs, and diagnostics per robot
  • Full compatibility with OTA updates, status tracking, and rollbacks

Supported Architectures⿻

Robotair supports both of the following configurations seamlessly:

  1. A robot with a single onboard computer
  2. A robot composed of multiple networked onboard computers (multi-agent setup)

Communication Model and Identity Grouping⿻

flowchart TD
    subgraph Robotair[Robotair Platform]
        Platform[Orchestrator and Control Plane]
    end

    subgraph Robot_OneComputer["Robot A (Single Computer)"]
        A1[robotair-agent]
    end

    subgraph Robot_MultiComputer["Robot B (Multi-Computer)"]
        B1["Agent on Jetson (Perception)"]
        B2["Agent on IPC (Control)"]
    end

    A1 <--> Platform
    B1 <--> Platform
    B2 <--> Platform

Onboarding Process⿻

  1. Define a new robot in the Robotair dashboard
  2. Run the provided install script on each compute unit that belongs to the robot
  3. Agents auto-register under the same robot identity using a secure token and shared configuration

Each robot, regardless of internal composition, becomes a first-class citizen in the Robotair platform, ready to receive updates, stream telemetry, and participate in fleet-wide automation workflows.