Robonomics implementation in Rust based on the Polkadot SDK. For more specific guides, like how to be a node, see the Robonomics Wiki.

Robonomics platform includes a set of open-source packages and infrastructure for Robotics, Smart Cities and Industry 4.0 developers.

The fastest way to get started with Robonomics is using Nix flakes to run directly from GitHub, or use pre-built binaries.

No downloads, no builds, no setup - just run! Nix will automatically fetch and cache the binary.

1. Install Nix with flakes support (one-time setup):

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install

2. Run Robonomics directly from GitHub:

# Run the latest version
nix run github:airalab/robonomics

# Run in development mode
nix run github:airalab/robonomics -- --dev

# Run a specific version
nix run github:airalab/robonomics/v4.1.0 -- --dev

3. Open Polkadot.js Apps to interact with your local node

That's it! Nix handles everything - downloads, dependencies, and caching. Works on Linux, macOS, and Windows (WSL).

1. Download the latest release:

# Visit https://get.robonomics.network
# Or download directly from releases
wget https://github.com/airalab/robonomics/releases/download/v4.1.0/robonomics
chmod +x robonomics

2. Run a local development node:

./robonomics --dev

3. Open Polkadot.js Apps to interact with your local node

Once you have a node running, you can:

• Open Polkadot.js Apps - Connect to your local node
• Connect to Robonomics Network - Connect to the live network
• Explore the Robonomics Wiki for tutorials
• Join our Matrix community for support

This repository is organized as a Cargo workspace with the following structure:

• bin/robonomics/ - Main binary implementation
  • The Robonomics Network Omni Node with CLI interface
  • Built using polkadot-omni-node-lib for maximum compatibility

• runtime/robonomics/ - Robonomics parachain runtime
  • WASM runtime implementation for the Robonomics Network
  • Includes configurations for Kusama and Polkadot relay chains
  • Integrates all custom pallets and standard Substrate pallets

• frame/ - Custom FRAME pallets for IoT and robotics
  • datalog/ - Immutable on-chain data logging with time-series storage
  • digital-twin/ - Digital twin state management and topic-based data organization
  • launch/ - Robot/device launch commands with parameter support
  • liability/ - Smart contract-like agreements for robotics tasks
  • rws/ - Robonomics Web Services (RWS) subscription management
  • cps/ - Cyber-physical Systems pallet for IoT integration
  • claim/ - Pallet for ERC20 token claim support
  • parachain-info/ - Original cumulus pallet extended with relay network info

• chains/ - Chain specification files for different networks

• tools/robonet/ - Local network spawner and integration test framework

  • CLI tool for spawning multi-node test networks using ZombieNet SDK
  • Built-in integration tests for XCM, CPS, Claim pallets, and network functionality
  • Multiple network topologies (simple parachain, with AssetHub for XCM testing)
  • Developer-friendly interface with progress indicators and detailed logging
  • See robonet/README.md for detailed documentation

• tools/libcps/ - Robonomics CPS (Cyber-Physical Systems) library and CLI

  • Comprehensive Rust library for managing hierarchical CPS nodes on-chain
  • Beautiful CLI interface with colored output and tree visualization
  • Multi-algorithm AEAD encryption support (XChaCha20-Poly1305, AES-256-GCM, ChaCha20-Poly1305)
  • MQTT bridge for IoT device integration
  • See libcps/README.md for detailed documentation

• nix/ - Nix flake modules and build configurations
• scripts/ - Build, deployment, and testing scripts
  • runtime-benchmarks.sh - Automated runtime benchmarking for all pallets
  • try-runtime.sh - Automated runtime upgrade checks
  • build-deb.sh - Debian package builder
  • build-runtime.sh - Deterministic runtime WASM builder
  • docker/ - Docker configuration and healthcheck scripts
  • weights/ - Weight template for runtime benchmarks

Development guidelines available at DEVELOPMENT.md.

Crates API is available at https://crates.robonomics.network.

Each component is designed to be modular and reusable, following Substrate's framework architecture. The workspace structure allows for efficient development and testing of individual components while maintaining consistency across the project.

We welcome contributions! Please see our Contributing Guidelines.

• Robonomics Wiki: https://wiki.robonomics.network
• GitHub Issues: https://github.com/airalab/robonomics/issues
• Website: https://robonomics.network

Robonomics is licensed under the Apache License 2.0. See LICENSE for details.