drone-swarm 0.1.0

Python SDK for multi-drone swarm orchestration over MAVLink

drone-swarm

Python SDK for multi-drone swarm orchestration.

Turn a collection of ArduPilot drones into a coordinated swarm with 10 lines of Python.

from drone_swarm import Swarm
import asyncio

async def main():
    swarm = Swarm()
    swarm.add("alpha", "udp:127.0.0.1:14550")
    swarm.add("bravo", "udp:127.0.0.1:14560")
    await swarm.connect()
    await swarm.takeoff(altitude=10)
    await swarm.formation("v", spacing=15)
    await swarm.rtl()

asyncio.run(main())

Why drone-swarm?

Problem	Status Quo	drone-swarm
Coordinate multiple drones	Raw MAVLink from scratch	swarm.formation("v")
Test without hardware	Manual SITL setup per drone	Swarm.simulate(n=5)
Handle mid-flight failures	Hope for the best	Auto-failsafe + replanning
Preflight safety checks	DIY scripts	run_preflight_checks()

Features

• Swarm coordination -- synchronized takeoff, landing, RTL, and formations
• Formation flying -- V-shape, line, grid, circle, orbit, and custom patterns
• Mission planning -- area sweep, patrol, orbit point, and intercept
• Safety first -- preflight checks (GPS, battery, compass, failsafes, Remote ID, vibration), geofencing, emergency land/kill
• Simulation -- built-in SITL launcher for hardware-free testing
• Async-native -- built on asyncio for concurrent multi-drone I/O
• Telemetry -- real-time position, battery, and heartbeat monitoring with auto-RTL on low battery
• Configurable -- YAML/dict config with sensible defaults

Quick Install

pip install drone-swarm

Requires Python 3.11+. For simulation support:

pip install drone-swarm[sim]

Documentation

Full docs, tutorials, and API reference: docs/index.md

Who is this for?

• Developers building drone applications (agriculture, inspection, SAR, mapping)
• Researchers studying swarm robotics and multi-agent coordination
• Students learning autonomous systems and MAVLink
• Startups building commercial drone services
• Defense integrators needing an open, auditable swarm layer

Contributing

Contributions welcome. See CONTRIBUTING.md for guidelines.

git clone https://github.com/yuyongju/drone-swarm.git
cd drone-swarm
pip install -e ".[dev]"
pytest

License

MIT License. See LICENSE for details.