Repository navigation
Home
ANet Relay is a desktop ground control station for small drone fleets on a local Wi-Fi network, built for teams in which people and agents fly together. An operator can possess any aircraft with a gamepad or the keyboard while agents, language models and onboard programs fly the rest. When the operator lets go, control is relayed back. A built-in rigid-body simulator, collision volumes, a LAN arena and a leaderboard make the whole loop available without hardware.
Current release: 0.5.4 · Download · Changelog · 简体中文
| If you want to | Read |
|---|---|
| Install the app | Installation |
| Fly a simulator in two minutes | Quick Start |
| Fly with a gamepad, keyboard or transmitter | Flying and Controls |
| Connect a real quadcopter | Real Aircraft · Safety |
| Let an agent or a language model fly | Agent API · MCP Servers · Copilot |
| Write programs that fly at 50 Hz | Onboard Programs · Lab, Challenges and Duels |
| Run a dogfight and a leaderboard | Dogfights and Leaderboard · LAN Arena |
| Understand the simulator | Simulator and Physics · Collisions and Rings |
| Fly the real PX4 or ArduPilot firmware in simulation, or a PX4 board in the loop | Firmware Twins and HITL |
| Use your own PX4 or ArduPilot SITL, or compare simulators | PX4 and ArduPilot SITL · Simulators Compared |
| Fix a problem | Troubleshooting · FAQ |
| Build or contribute | Building from Source |
Every aircraft has at most one controller at a time. An agent opens a session, claims aircraft and flies them. A person who possesses an aircraft always wins: the agent's claim is suspended and every control call returns possessed_by_human until the person releases, when the agent receives relay_handback. Language models are too slow to hold a quadcopter in the air, so by default agents fly with sticks only and put the fast loop into an onboard program, restricted Python that runs at 50 Hz and outputs sticks. The agent writes, tests and tunes the program; the program flies.
The wiki is the guide. The full references live next to the code and are versioned with it:
- Agent API guide: every endpoint, event, error and SDK call
- Onboard programs guide: language, observation, library, challenges, duels and trace format
- Simulation guide
- Hardware guide (Chinese) and flight tuning guide (Chinese)
- Design documents (Chinese): the binding product, experience and system design of each version
Get started
Simulation
- Simulator and Physics
- Collisions and Rings
- Firmware Twins and HITL
- PX4 and ArduPilot SITL
- Simulators Compared
Arena
Programs and agents
Tools
Help