STAKEFLY / docs watch it live

Attribution

Third-party material

Everything Trenchfly borrows, with its licence and what we owe it.

MaleCNS v1.0 connectome — CC BY 4.0

Janelia Research Campus / FlyEM, male Drosophila melanogaster central nervous system connectome, v1.0 (165,122 neurons, 25,563,197 traced connections).

Used for: the graph itself (data/graph-traced-v1/), neuron metadata, and the skeletons and neuropil meshes rendered by the web app (web/public/brain/, produced by T07). web/public/brain/manifest.json records every source URL and SHA-256 next to the files.

CC BY 4.0 requires attribution wherever the data or anything derived from it is shown. The web app and the docs site must carry the credit, and downloaded artefacts keep their source URLs and checksums in the manifest next to them.

flyhard — MIT

https://github.com/MarkUnthank/flyhard by Mark Unthank. The same connectome trained to steer a car in CARLA.

Copied or ported here: scripts/acquire_connectome.py, scripts/prepare_graph.py, src/flyhard/connectome.py (SparseConnectome), scripts/acquire_cns_geometry.py, scripts/cns_view.py, benchmark_core.py.

MIT requires the copyright notice and licence text to travel with the copied source; each ported file keeps a header saying where it came from. Still vendored after the slots pivot (S00): fly/data/acquire_connectome.py, fly/data/prepare_graph.py (T02, byte-identical apart from the attribution header and exempted from ruff) and fly/geometry.py (from scripts/acquire_cns_geometry.py, T07 — the fetch and decode machinery is flyhard's, the selection, contraction and output format are ours). SparseConnectome and the benchmark were removed with the rate model.

MIT License

Copyright (c) 2026 Mark Unthank

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

fly-wirehead — MIT

https://github.com/mattyhempstead/fly-wirehead by Matty Hempstead, itself adapted from stonkfly (below). The same connectome run as a spiking network watching a phone, with a KC→MBON plasticity rule driven by current into the PAM11 dopamine cells.

Vendored at S01 (2026-09-11) from commit fcefe94, recorded in fly/neural/upstream.json:

  • fly/neural/{brain,circuit,common,connectome,prepare,rule,sensory,state,transmitters,visual}.py, fly/neural/kernel.cpp, fly/neural/{arrays.lock,datasets,neurons.lock,sources.lock}.json — byte-identical to flywirehead/neural/, exempted from ruff.
  • fly/engine.py from flywirehead/engine.py (adapted: reward and aversive arguments, the Spin readout) and fly/prepare.py from flywirehead/data.py (import path only).
  • fly/neural/LICENSE-stonkfly-MIT.txt is the licence file that travels with the kernel.

rule.py is an adaptation of Huang, Luo et al. 2024 (doi:10.1038/s41586-024-07819-w). The presentation ideas (fly as hero, phone in front, PAM11 chart, motor readout as animation, wake-up under white light) are borrowed as ideas, not code.

stonkfly — MIT

https://github.com/nftechie/stonkfly by nftechie and DOOMFLY contributors. The origin of the kernel and the plasticity rule above; also the source of the PPL101 aversive wiring we keep as a switch. docs/reports/stonkfly-comparison.md is the nose-era comparison.

The MIT text above applies to both, with their respective copyright lines, which travel in the vendored file headers.

FlyGym / NeuroMechFly — Apache 2.0

https://github.com/NeLy-EPFL/flygym. Not used. The plan was to take the NeuroMechFly mesh for the fly-on-a-laptop scene, but FlyGym ships it as a MuJoCo model whose data files are not fetchable from the paths in its docs, and converting plus rigging it would cost more than it returns at 372 px on a stream. T11 permits a stylised fly, so web/src/rig.ts builds one in code. Nothing from FlyGym is vendored; this entry stays as a record of the decision.

Entries are added as each task actually vendors something; a file that copies third-party code is not merged until it is listed here.