ROBIN Documentation

ROBIN: Open Process Intelligence Core

Python Version ROS 2 FastAPI FIWARE

Overview

ROBIN provides two reusable open-source modules and a documented integration pattern for robotic process intelligence:

  • Module 1 - Process Intelligence API (robin/): FastAPI service for process lifecycle management, deviation detection, and AI-assisted recommendations over FIWARE/NGSI-LD data.

  • Module 2 - Monitoring Dashboard (robin-dashboard/): Configurable React operator dashboard for live monitoring, alerts, and AI model management.

  • Integration pattern - ROS 2 to FIWARE: A normalized telemetry schema, demo publisher, optional aggregation path, and DDS mapping config that connect ROS 2 process data to the FIWARE data layer via Orion-LD’s built-in DDS bridge.

The components are domain-agnostic: they work for welding, spray coating, machining, or any robotic manufacturing process.

        graph LR
    subgraph ros2 ["Integration Pattern"]
        SRC["Robot / Sensors"] --> AGG["Telemetry\nPublisher / Aggregator"]
        AGG --> TEL["/robin/telemetry"]
    end
    subgraph fiware ["FIWARE"]
        ORION["Orion-LD"] --> TSDB[("TimescaleDB")]
        TSDB --> MINTAKA["Mintaka"]
    end
    subgraph mod1 ["Module 1"]
        ALERT["Alert Engine\n+ AI Model"]
    end
    subgraph mod2 ["Module 2"]
        UI["ROBIN Dashboard"]
    end
    TEL -->|DDS| ORION
    ALERT --> ORION
    ALERT --> MINTAKA
    UI --> ALERT

Example Applications

The repository includes demo profiles that compose the modules into working stacks for different industrial domains:

  • No-hardware hello world: Quick Start Guide creates a process, ingests one mock measurement, reads it through the API, and requests an AI-assisted prediction without industrial hardware or private credentials.

  • Welding (reference): python demo/profiles/welding_profile.py --mode both

  • Spray Coating: ROBIN_PROFILE=spray_coating docker compose up -d then python demo/profiles/spray_coating_profile.py --mode both

No module code is modified when switching domains. See demo/profiles/README.md for the full comparison.

New here? Start with Quick Start Guide - the minimal, no-hardware, copy-paste hello world - then run the simulated welding demo in Demo Scripts & Simulations. The same modules adapt to other robotized processes by swapping the profile configuration rather than the module code (see Domain Profiles).

For ARISE catalog alignment, see:

  • ../arise/catalog-metadata.yaml

Target Readiness Level

Current Status: Physical welding-cell demonstrator validated at TRL6-7, with the open repository packaging the reusable FIWARE data layer, DDS telemetry ingestion, ROS 2 integration pattern, dashboard, and no-hardware evaluation path.

Target Readiness Level: TRL6-7 for the documented reference demonstrator. Further production hardening, broader adapter coverage, and additional non-welding validation remain future work.

Documentation Structure

Getting Started

User Guide

Reference

Release

Architecture & Operations

Community & Support

License

This project is licensed under AGPL-3.0-only as specified in the LICENSE file. Third-party and template-origin notices are documented in THIRD_PARTY_LICENSES.md.

Indices and tables