shute2004/virtual-fly

virtual-fly

English · 日本語 · 简体中文

virtual-fly is a research project that starts from the released adult male Drosophila MaleCNS connectome and evolves neural activity, neuromodulation, and local synaptic plasticity in closed loop with a FlyBody / MuJoCo body and a physical environment.

This Hugging Face repository provides an overview of virtual-fly and hosts the four published checkpoints in one repository. Source code, scientific documentation, canonical manifests, and the end-to-end reproducer live on GitHub:

• —GitHub: https://github.com/shute2004/virtual-fly
• —English documentation: https://github.com/shute2004/virtual-fly/tree/main/docs/en
• —日本語: https://github.com/shute2004/virtual-fly/blob/main/README.ja.md
• —简体中文: https://github.com/shute2004/virtual-fly/blob/main/README.zh-CN.md

Checkpoints

The checkpoint release has two distinct lineages. Do not treat the historical video pair as the canonical initial/trained pair.

Canonical v1

The canonical repository date is 2026-09-20.

The recorded canonical v1 experiment was actually run at Git commit 7fa464aad7269d34f46f1171080b51e095d1d811. Before public release, a privacy-only history rewrite produced public scientific equivalent f9c86c904d67ff974f3c43d37aab3619bc93fc1b; only historical absolute-path usernames changed, not executable source or canonical conditions. The short canonical run changed exactly 2,163,179 stored edges, but its frozen initial and final evaluations had the same categorical outcome. It therefore demonstrates current-semantics local-plasticity weight change, not established behavioral improvement.

Historical Before / After video

The historical checkpoint metadata records the internal development versions (v240 and v966) as provenance; those numbers are intentionally kept out of the top-level public naming. The Before checkpoint is already a historically trained v240 state, not an untrained initial state; the playback was not held out and retained task-triggered PAM stimulation while plasticity was off. The v966 checkpoint belongs to a mixed older lineage. These checkpoints are not canonical v1 evidence.

What is hosted here

Each checkpoint directory contains checkpoint files plus lightweight provenance, hashes, attribution, and a model card. They do not mirror the full research workspace.

Not hosted here by default:

• —raw MaleCNS downloads;
• —normalized MaleCNS snapshots;
• —FlyBody / FlyGym / MuJoCo source or body assets;
• —full trajectory directories;
• —rendered frame directories;
• —unrelated development checkpoints;
• —build caches or virtual environments.

The official MaleCNS source and the GitHub canonical reproducer remain the acquisition/reconstruction path for upstream data and derived static data.

Licensing and attribution

The original virtual-fly source code and documentation are MIT licensed. The checkpoint weights derive from the MaleCNS male-cns:v1.0 dataset, which the official MaleCNS site distributes under CC BY 4.0. The checkpoint artifacts are distributed under cc-by-4.0 and carry explicit MaleCNS attribution.

FlyBody, FlyGym, and MuJoCo remain under their upstream licenses and are not copied into this repository merely for convenience.

See the GitHub repository's THIRD_PARTY_NOTICES.md for the detailed boundary.

Reproduction

For the current canonical experiment and full source-level provenance, use:

git clone https://github.com/shute2004/virtual-fly.git
cd virtual-fly
uv sync --frozen
bash canonical/canonical-v1/reproduce.sh

The Hugging Face checkpoint directories are a distribution convenience. The GitHub canonical package remains the scientific definition of canonical v1.