virtual-fly

virtual-flyは、成体オスのショウジョウバエの公開MaleCNSコネクトームを初期状態として、神経活動・神経修飾・局所シナプス可塑性を時間発展させ、FlyBody / MuJoCoの身体と物理環境に閉ループ接続する研究プロジェクトです。

このHugging Faceリポジトリでは、virtual-flyの概要と、公開済みの4つのチェックポイントをまとめています。ソースコード、科学的な説明、canonical実験のmanifest、一連の再現スクリプトはGitHubにあります。

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

チェックポイントを取得

4つのチェックポイントは、すべてこのリポジトリから取得できます。Canonical v1と過去の比較動画用チェックポイントは別系統です。

配布物	役割	ファイル
Canonical v1 — 初期	canonical v1の初期状態。global weight version 0	開く
Canonical v1 — 学習後	canonicalの6エピソード学習後。global weight version 6	開く
過去動画 — Before	比較動画のBefore側で実際に使用したチェックポイント	開く
過去動画 — After	比較動画のAfter側で実際に使用したチェックポイント	開く

Hugging Face CLIでは、必要な配布物だけを取得できます。

hf download hf://shute2004/virtual-fly/checkpoints/canonical-v1/initial/ --local-dir virtual-fly-canonical-initial
hf download hf://shute2004/virtual-fly/checkpoints/canonical-v1/trained/ --local-dir virtual-fly-canonical-trained
hf download hf://shute2004/virtual-fly/checkpoints/historical-video/before/ --local-dir virtual-fly-video-before
hf download hf://shute2004/virtual-fly/checkpoints/historical-video/after/ --local-dir virtual-fly-video-after

各配布物には、チェックポイント本体に加えて、来歴情報、SHA-256、帰属情報、READMEが含まれます。

チェックポイント

公開チェックポイントには、明確に異なる2つの系統があります。動画用のBefore / Afterをcanonical v1の初期・学習後チェックポイントとして扱わないでください。

Canonical v1

canonical系の公開日は2026年9月20日です。

チェックポイント	ファイル	意味
初期	`checkpoints/canonical-v1/initial`	canonical v1の初期チェックポイント。global weight version 0
学習後	`checkpoints/canonical-v1/trained`	canonical v1で6エピソードの学習処理を経たチェックポイント。global weight version 6

記録済みのcanonical v1実験は、実際にはGit commit 7fa464aad7269d34f46f1171080b51e095d1d811で実行しました。公開前のprivacy-onlyな履歴書き換え後、公開用の科学コード相当commitはf9c86c904d67ff974f3c43d37aab3619bc93fc1bです。変更はhistorical absolute path内のローカルOSユーザー名だけで、実行コードやcanonical条件は変わっていません。この短いcanonical実験では、保存された25,582,938本の辺のうち2,163,179本で重みが変化しました。一方、可塑性とタスク由来のDAN刺激を無効化した固定評価では、初期・学習後とも同じ分類上の結果でした。

したがってcanonical v1が示しているのは、現行の局所可塑性の意味づけのもとで保存重みが実際に変化したことであり、明確な行動改善や一般化を実証したという主張ではありません。

過去系統のBefore / After動画

チェックポイント	ファイル	来歴上の役割
Before	`checkpoints/historical-video/before`	公開したBefore / After比較動画のBefore側で実際に使用した過去系統のチェックポイント
After	`checkpoints/historical-video/after`	同じ動画のAfter側で実際に使用した過去系統のチェックポイント

これらの内部開発版は来歴情報としてv240とv966ですが、最上位の公開名には出していません。Before側のv240は未学習の初期状態ではなく、すでに240エピソードの過去学習を経ています。再生はホールドアウト評価ではなく、可塑性を停止した状態でも課題イベントによるPAM刺激は有効でした。v966も複数の過去条件が混在した系統です。したがって、これらはcanonical v1の証拠ではありません。

Hugging Faceに置くもの

各チェックポイントのディレクトリには、チェックポイント本体と、必要最小限の来歴情報、ハッシュ値、帰属情報、モデルカードを置きます。研究用作業環境全体を複製するものではありません。

原則として置かないもの:

MaleCNSの生データ
正規化済みMaleCNSスナップショット一式
FlyBody / FlyGym / MuJoCoのソースコードや身体資産
軌跡データ一式
描画フレーム一式
今回の公開対象と無関係な開発途中のチェックポイント
ビルドキャッシュや仮想環境

上流データと、そこから生成する静的データについては、MaleCNS公式配布元とGitHubのcanonical再現スクリプトを取得・再生成の正規経路とします。

ライセンスと帰属

virtual-fly独自のソースコードと文書はMIT Licenseで公開します。チェックポイントの重みは、MaleCNS公式サイトがCC BY 4.0で配布しているmale-cns:v1.0を基礎として生成した派生データです。そのため、チェックポイント成果物はcc-by-4.0として配布し、MaleCNSへの帰属情報を付けます。

FlyBody、FlyGym、MuJoCoはそれぞれ上流のライセンスに従い、利便性だけを理由にこのリポジトリへ複製しません。

詳しい境界はGitHubリポジトリのTHIRD_PARTY_NOTICES.mdを参照してください。

再現

現在のcanonical実験とソースレベルの完全な来歴については、GitHub側を使用してください。

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

Hugging Faceの各チェックポイントディレクトリは、チェックポイントを配布するためのものです。canonical v1の科学的な定義は、GitHub上のcanonicalパッケージを基準とします。