Close the loop from a measured nervous system to a physical body.
No controller written by anyone.
therealfly wires the Janelia FlyEM male CNS connectome (165,122 neurons, 10.2 M synapses) into the open-source flybody MuJoCo fly. This installer walks you through the two Python environments, the public connectome download, and the smoke test — with an AI assistant that remembers your machine.
Step-by-step wizard
Nine steps from clone to smoke test, with copy-paste PowerShell commands and a live progress bar.
Streaming AI assistant
Vercel AI SDK + AI Elements. The agent reads command output you paste back and tells you what's next.
Multi-model cast
Anthropic, OpenAI, Google, or any OpenAI-compatible endpoint — each with per-model timeout, reasoning hints, and live event subscription.
Wallet auth (ASTEROID)
Phantom wallet sign-in with HMAC session tokens, mobile deep-link, and per-user throttling.
Connectome viewer (flycoin)
FlyEM male CNS validation table, proboscis extension viewer, population decoder, opt-in pump.fun bridge.
Two-environment awareness
Python 3.14 default for the cord, uv-made 3.12 venv for the body. The wizard knows the difference.
Modules
Four integrated components share the SQLite, the auth layer, the cast, and the event log. Each module owns its own screens but reads and writes through the shared interfaces.
The four stages
The installer gets you through stages 0 and 1. Stages 2 and 3 require a body environment and a successful cord protocol; the README documents them as “built, not run”.
| Stage | Question | Status |
|---|---|---|
| 0 | Motor map | done in repo |
| 1 | Cord rhythm | PASS = false (by design) |
| 2 | Body open-loop | built, not run |
| 3 | Closed-loop proprioception | built, not run |
What you need on this machine
- Windows 11 with the
pylauncher (macOS / Linux work too — swap the launcher). - Python 3.12 or newer for the default environment; Python 3.12 from uv for the body.
- ~6 GB free RAM for stage 1 (it refuses to start with less).
- 3 GB of free disk for the three FlyEM data files plus the graph build.
- One provider key for the assistant — Anthropic, OpenAI, Google, or any OpenAI-compatible endpoint.
Need a hand? Open the installer and the agent will guide you through each step.