Skip to content

Repository files navigation

AetherSwarm

Introducing AetherSwarm: Edge-Native, Fully Decentralized Swarm Robotics Platform What if robots could collaborate intelligently without relying on the cloud, Wi-Fi, or a central controller?

I'm excited to introduce AetherSwarm—a next-generation, edge-native swarm robotics platform designed for environments where resilience, autonomy, and real-time collaboration are mission-critical.

Imagine deploying 16–50 autonomous robots into disaster zones, agricultural fields, underground mines, or other communication-denied environments. Rather than depending on a centralized system, every robot operates as an intelligent SwarmNode, making local decisions while seamlessly collaborating with neighboring nodes through decentralized peer-to-peer communication.

🔹Core Capabilities

  1. Autonomous Peer Discovery – Dynamically detects and connects with nearby robots.
  2. Distributed Task Negotiation – Assigns and balances workloads collaboratively without a central coordinator.
  3. Shared Spatial Intelligence – Builds and synchronizes distributed environmental knowledge across the swarm.
  4. Edge-Native Decision Making – Executes behaviors locally for ultra-low latency and real-time responsiveness.
  5. Self-Healing Collaboration – Automatically adapts to robot failures, changing conditions, and dynamic missions.
  6. Infrastructure-Free Operation – Continues functioning with limited or no internet connectivity.

🌍 Applications

  1. 🚑 Disaster Search & Rescue
  2. 🌾 Precision Agriculture
  3. ⛏️ Mining & Industrial Inspection
  4. 🏭 Smart Manufacturing
  5. 🛡️ Defense & Security
  6. 🌊 Environmental Monitoring
  7. 🚁 Autonomous Exploration Missions

💡 Why AetherSwarm? Traditional robotic fleets often depend on centralized coordination, creating a single point of failure. AetherSwarm eliminates this limitation by embracing decentralized swarm intelligence.

  1. ✅ Fully decentralized architecture
  2. ✅ No cloud dependency
  3. ✅ No single point of failure
  4. ✅ Self-organizing autonomous agents
  5. ✅ Fault-tolerant collaboration
  6. ✅ Scalable swarm coordination
  7. ✅ Edge-first AI intelligence

AetherSwarm represents the convergence of Swarm Robotics, Edge AI, Distributed Systems, Multi-Agent Intelligence, and Autonomous Computing—bringing us closer to robotic ecosystems that are adaptive, resilient, and capable of solving complex real-world challenges without centralized infrastructure. The future of robotics isn't a single powerful machine.

It's an intelligent swarm working together.

I'd love to hear your thoughts from researchers, robotics engineers, and AI enthusiasts. What real-world application would you like to see built with decentralized swarm intelligence?

🔥AetherSwarm - Demo

AetherSwarm.mp4

Architecture

aether_swarm/
├── hardware/hal.py              Hardware Abstraction Layer (motors, sensors, E-Stop)
├── engine/wasm_runtime.py       Wasmtime sandbox for hot-swappable behaviors
├── engine/behaviors.py          9 micro-behaviors (flocking, obstacle avoidance, etc.)
├── mesh/p2p_mesh.py             P2P mesh network (ChaCha20-Poly1305 encrypted)
├── spatial/vector_memory.py     Qdrant 3D spatial vector memory
├── swarm/contract_net.py        Market-based Contract Net Protocol (task bidding)
├── swarm_node.py                Autonomous SwarmNode agent (100Hz tick)
├── simulator/simulator.py       Multi-agent simulator (4 scenarios)
├── dashboard/server.py          FastAPI + WebSocket real-time dashboard
├── ai/providers.py              Multi-provider AI fallback (DeepSeek → Qwen → Hunyuan)
├── ai/semantic_engine.py        LLM-powered spatial reasoning
└── database/                    MySQL integration (mission logs)
main.py                          CLI entry point

Quick Start

# Install dependencies
pip install -r requirements.txt

# Run a simulation
python main.py --scenario flocking_demo --duration 10

# Run with dashboard
python main.py --scenario disaster_response --dashboard

CLI Options

Flag Short Description
--scenario -s disaster_response, agriculture, infrastructure, flocking_demo
--duration -d Runtime in seconds (0 = indefinite)
--verbose -v Enable debug logging
--dashboard Launch web dashboard at http://localhost:8765
--dashboard-port Dashboard port (default 8765)
--nodes -n Override node count
--packet-loss -p Simulate network loss (0.0–1.0)

Scenarios

Scenario Nodes Use Case
disaster_response 50 Survivor search with thermal imaging, high packet loss
agriculture 8 Precision pesticide dosing via crop detection
infrastructure 10 Structural crack/anomaly inspection
flocking_demo 16 Formation flight and flocking

Behaviors (9 total)

Behavior Priority Description
obstacle_avoidance 9 LiDAR potential field navigation
flocking 7 Boids algorithm (separation, alignment, cohesion)
line_inspection 6 PID line tracking
perimeter_patrol 5 Waypoint navigation
formation_hold 8 UWB position hold
survivor_search 10 Thermal search spiral
pesticide_dose 4 Crop detection
structural_inspect 8 Anomaly detection
idle_hold 0 Stationary fallback

Subsystems

Hardware Abstraction Layer

  • 4 motor types (differential, holonomic, skid-steer, ackermann)
  • 6 sensors (LiDAR, thermal camera, depth camera, IMU, GPS, ultrasonic)
  • E-Stop watchdog (500ms timeout, motor kill on fault)

P2P Mesh Network

  • Neighbor discovery with heartbeat
  • Pub/sub topics with wildcard routing
  • ChaCha20-Poly1305 simulated encryption
  • Designed for Eclipse Zenoh (simulated mode available)

Wasm Behavior Engine

  • Sandboxed hot-swappable behaviors
  • SIMD acceleration support
  • Behavior registry with hardware compatibility matching
  • Hot-swap latency < 1ms (simulated)

Spatial Vector Memory

  • 3D point cloud with semantic embeddings
  • KNN spatial queries
  • Threat/risk classification
  • Qdrant-compatible (in-memory fallback)

Contract Net Protocol

  • Market-based task allocation
  • Multi-factor bidding (capability, proximity, energy)
  • Task timeout and reallocation
  • 2000ms bid window

Target Hardware

Platform Role
NVIDIA Jetson Orin Nano/NX Primary compute
ESP32-S3 Sensor nodes, mesh relays
Raspberry Pi Zero 2W Lightweight edge nodes

Environment Variables

Copy .env.example to .env and configure:

# MySQL Database
DB_NAME=AetherSwarm
DB_USER=root
DB_PASSWORD=your_password
DB_HOST=127.0.0.1
DB_PORT=3306

# AI Providers (multi-provider fallback)
DEEPSEEK_API_KEY=sk-...
QWEN_API_KEY=sk-...
HUNYUAN_API_KEY=sk-...

Requirements

  • Python 3.11+
  • Optional: Rust toolchain (for Wasm behavior compilation)
  • Optional: Eclipse Zenoh (production P2P mesh)
  • Optional: Qdrant (production vector store)
  • Optional: MySQL 8.0+ (mission logging)

License

Proprietary — AetherSwarm Research Lab

About

AetherSwarm—a next-generation, edge-native swarm robotics platform designed for environments where resilience, autonomy, and real-time collaboration are mission-critical.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages