omniedge

OmniEdge

Zero-Config P2P Mesh VPN for AI, Robotics, and Edge Computing

The Problem

Building distributed AI systems is hard. Connecting robots, edge devices, and cloud infrastructure across networks is even harder:

• Your robot fleet can't communicate behind NAT
• Federated learning nodes need secure, low-latency links
• Remote debugging AI devices requires complex VPN setup
• Multi-agent systems need peer discovery without central servers
• Humanoid robot teleoperation demands deterministic, jitter-free networking

OmniEdge solves this with a single binary.

Why Researchers & Developers Choose OmniEdge

Performance: Industrial-Grade Stability

Validated through 50-run longitudinal testing using Process Capability Analysis (Cpk):

What this means: Cpk > 2.0 indicates industrial-grade process capability. OmniEdge provides deterministic, jitter-controlled networking suitable for real-time robot control and latency-sensitive AI inference.

Perfect For

Robotics

• Humanoid Teleoperation: Deterministic latency for real-time control loops
• Robot Swarms: Mesh networking for multi-robot coordination
• ROS 2 Integration: Seamless DDS discovery across networks
• Remote Debugging: SSH into any robot without port forwarding

AI & Machine Learning

• Federated Learning: Secure gradient exchange between edge nodes
• Distributed Inference: Split models across Jetson/Pi clusters
• MLOps Pipelines: Deploy models to edge devices seamlessly
• GPU Cluster Access: Connect to remote training infrastructure

Research

• Multi-Agent Systems: P2P communication for agent coordination
• Edge Computing: Connect fog nodes to cloud transparently
• IoT Testbeds: Instant mesh for sensor networks
• Reproducible Experiments: Consistent networking across trials

Quick Start (60 seconds)

# Install on any Linux device (Jetson, Pi, server)
curl -fsSL https://raw.githubusercontent.com/omniedgeio/omniedge/main/scripts/omniedge-install.sh | bash

# Start and connect (interactive login on first run)
sudo omniedge start

# That's it. Your devices can now reach each other by virtual IP.

Nucleus Mode Custom Server

When running omniedge start --mode nucleus or --mode dual, the CLI can auto-register a custom user server using the public IP and chosen port. This requires an auth token; if auth is missing or public IP lookup fails, it skips registration and continues.

OpenWrt Installation

# Download the package for your architecture (example: aarch64, OpenWrt 24.10)
wget https://github.com/omniedgeio/omniedge/releases/download/v2.9.0/omniedge_2.9.0_aarch64_generic.ipk

# Install the package
opkg install omniedge_2.9.0_aarch64_generic.ipk

# Configure via UCI
uci set omniedge.main.enabled='1'
uci set omniedge.main.network_id='your-network-id'
uci commit omniedge

# Start the service
/etc/init.d/omniedge start
/etc/init.d/omniedge enable  # Start on boot

Supported Hardware

Supported Platforms

CLI (omniedge-cli)

Desktop (omniedge-desktop)

OpenWrt (omniedge-openwrt)

Note: MIPS architecture is not supported due to Rust toolchain limitations.

Architecture

…

Plugin System (v2.2.0)

OmniEdge now supports a WASM-based plugin system that allows extending functionality without modifying the core application.

Features

Plugin Capabilities

Installing Plugins

…

Creating Plugins

See examples/plugins/hello-world for a complete example.

// Minimal plugin structure
wit_bindgen::generate!({
    world: "omniedge-plugin",
    exports: {
        world: MyPlugin,
    },
});

struct MyPlugin;

impl Guest for MyPlugin {
    fn on_load() -> Result {
        Ok(())
    }
}

NAT Traversal (v2.1.0)

OmniEdge automatically handles complex network environments with multi-layer NAT traversal:

How It Works

┌─────────────────────────────────────────────────────────────────┐
│                    NAT Traversal Stack                          │
├─────────────────────────────────────────────────────────────────┤
│  1. STUN Detection    → Identify NAT type (Open/Cone/Symmetric) │
│  2. UDP Hole Punching → Direct P2P for compatible NAT types     │
│  3. Port Mapping      → UPnP/NAT-PMP to open router ports       │
│  4. Relay Fallback    → Zero-knowledge relay for symmetric NAT  │
└─────────────────────────────────────────────────────────────────┘

NAT Type Compatibility

Features

Configuration

# Check your NAT type and settings
omniedge status

# Configure NAT traversal
omniedge config show              # View current settings
omniedge config relay on          # Enable relay fallback
omniedge config portmap on        # Enable UPnP/NAT-PMP
omniedge config ipv6 prefer       # Prefer IPv6 when faster
omniedge config encrypt on        # Enable encrypted signaling

Operating Modes

# Edge mode - Join an existing network
sudo omniedge start -n 

# Nucleus mode - Run your own signaling server (air-gapped labs)
sudo omniedge start --mode nucleus --port 51821 --secret "YourLabSecret123"

# Dual mode - Hub node that also participates in mesh
sudo omniedge start -n  --mode dual --secret "YourSecret123456"

Transport Modes (v2.5.0)

OmniEdge supports two transport modes for different networking requirements:

L3 Mode (Default)

Layer 3 mode operates at the IP level, routing IP packets between peers. This is the default and works on all platforms.

# L3 mode (default - no flag needed)
sudo omniedge start -n 

# Explicit L3 mode
sudo omniedge start -n  --transport-mode l3

L2 Mode (Linux Only)

Layer 2 mode operates at the Ethernet level, bridging Ethernet frames between peers. This enables:

• Non-IP Protocols: ARP, DHCP relay, NetBIOS, STP
• MAC Address Visibility: See actua