Swarm

<a id="readme-top"></a>

<p align="center">
  <img src="https://raw.githubusercontent.com/swarm-subnet/swarm/main/swarm/assets/Swarm_2.png" alt="Swarm" width="62%" />
</p>

<h1 align="center">Swarm</h1>

<p align="center">
  <b>The open arena where AI learns to fly.</b><br/>
  <i>Train a drone pilot, prove it against the world, and watch it fly.</i>
</p>

<p align="center">
  <a href="https://github.com/swarm-subnet/swarm/releases"><img alt="Version" src="https://img.shields.io/badge/version-v5.1.5.0-F5D400?style=flat-square&labelColor=111111" /></a>
  <a href="https://discord.gg/8dPqPDw7GC"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&logo=discord&logoColor=white" /></a>
  <a href="https://x.com/SwarmSubnet"><img alt="X" src="https://img.shields.io/badge/X-Follow-111111?style=flat-square&logo=x&logoColor=white" /></a>
  <a href="https://swarm124.com"><img alt="Website" src="https://img.shields.io/badge/swarm124.com-visit-F5D400?style=flat-square&labelColor=111111" /></a>
</p>

<p align="center">
  <a href="miner/docs/miner.md"><img alt="Start Training" src="https://img.shields.io/badge/Start%20Training-Miner%20Guide-F5D400?style=for-the-badge" /></a>
  &nbsp;
  <a href="https://swarm124.com/benchmark"><img alt="Leaderboard" src="https://img.shields.io/badge/Leaderboard-Live-111111?style=for-the-badge" /></a>
</p>

---

<!-- ABOUT -->
## What Is Swarm

Drones are moving into everyday life: delivering packages, inspecting bridges and power lines, searching for survivors after a disaster. The hardware is ready. The hard part is the **AI that flies them**, and today that AI is built behind closed doors, where no one can compare it or prove whose is best.

**Swarm is the open arena that settles it.** Anyone can train a drone pilot, submit it, and watch it compete on a public [leaderboard](https://swarm124.com/benchmark) across thousands of fresh worlds it has never seen. No private test sets, no memorizing, no shortcuts. The best pilot wins, out in the open, and its rewards are paid automatically by the [Bittensor](https://bittensor.com) network (Subnet 124).

<https://github.com/user-attachments/assets/ee579a55-5eb2-4f6c-83db-4b1a223b9bb2>

<p align="center">
  <sub><b>Search and Rescue.</b> The mission Swarm is built around: teaching a drone to find people.</sub>
</p>

<p align="center">
  <sub><b>1</b> live mission &nbsp;·&nbsp; fresh worlds every 14-day epoch &nbsp;·&nbsp; the same on every validator &nbsp;·&nbsp; one live leaderboard</sub>
</p>

<p align="right">(<a href="#readme-top">back to top</a>)</p>

---

<!-- CHALLENGE FAMILIES -->
## The Mission

Swarm Sentinel is the live competition, with its own champions and the whole reward. The missions that came before it are completed, and their guides stay in [completed families](docs/families/completed/README.md).

| Mission | What your drone has to do | Reward share |
|---------|---------------------------|:------------:|
| **[Swarm Sentinel](docs/families/solar_patrol.md)** | Patrol a solar park from its drone dock by day and by night, report every intruder, and land back in the dock | <img src="https://img.shields.io/badge/100%25-F5D400?style=flat-square" alt="100%" /> |

<p align="center"><sub>The mission has a full guide with everything a builder needs to start.</sub></p>

<p align="center"><sub><b><a href="docs/families/completed/README.md">Completed</a>:</b> <a href="docs/families/completed/interceptor.md">Interceptor</a>, whose champion cleared it and whose winning solution is open source, and <a href="docs/families/completed/autopilot.md">Autopilot</a>, <a href="docs/families/completed/swarm_autopilot.md">Swarm Autopilot</a> and <a href="docs/families/completed/interceptor_office.md">Office Interceptor</a>, whose place Swarm Sentinel took. Their guides stay online and their champions stay published.</sub></p>

<p align="right">(<a href="#readme-top">back to top</a>)</p>

---

<!-- WATCH: INTERCEPTOR -->
## Watch: Interceptor

<https://github.com/user-attachments/assets/a16e9453-663c-4483-a3b8-160c412fd3e7>

<p align="center">
  <sub><b>Air-to-air pursuit,</b> from a real benchmark run: close the gap and catch a fleeing drone before the clock runs out.</sub>
</p>

<p align="right">(<a href="#readme-top">back to top</a>)</p>

---

<!-- HOW IT WORKS -->
## How It Works

Every mission runs the same simple loop:

<table align="center">
<tr>
<td align="center"><b>Depth Camera</b><br><sub>what's in front of it</sub></td>
<td align="center" rowspan="2"><b>&nbsp;→&nbsp; Your Model &nbsp;→&nbsp;</b></td>
<td align="center" rowspan="2"><b>Flight Commands</b><br><sub>where to fly next</sub></td>
<td align="center" rowspan="2"><b>&nbsp;→&nbsp; Drone</b></td>
</tr>
<tr>
<td align="center"><b>Flight State</b><br><sub>position and speed</sub></td>
</tr>
</table>

<table>
<tr>
<td align="center" width="50%">
<img src="https://raw.githubusercontent.com/swarm-subnet/swarm/main/swarm/assets/Drone_flying.gif" alt="Drone navigating a procedural city" width="100%">
<br><sub>Third-person view</sub>
</td>
<td align="center" width="50%">
<img src="https://raw.githubusercontent.com/swarm-subnet/swarm/main/swarm/assets/Drone_flying_FPV.gif" alt="What the drone sees" width="100%">
<br><sub>What the drone sees</sub>
</td>
</tr>
</table>

In the rescue missions the drone sees the world through a depth camera, can ask for a colour picture, and knows its own position and speed. Fifty times a second, your model looks at that and decides where to fly next: a direction, a speed, a turn. No map, no GPS, no list of obstacles. Just like a real pilot, it has to read what is in front of it and react. Swarm Sentinel flies the real drone's own kit instead: colour, thermal and zoom cameras, a laser rangefinder and the dock's survey of the site, with a decision ten times a second. The rescue missions are completed; Swarm Sentinel is the live one.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

---

<!-- ENVIRON