Hugging Face's logo

shute2004
/
virtual-fly

English
Japanese
Chinese
drosophila
connectome
computational-neuroscience
neuromodulation
synaptic-plasticity
embodied-simulation
reproducible-research
Model card Files
xet
 Community
virtual-fly / README.zh-CN.md
shute2004's picture
shute2004
Improve checkpoint distribution navigation
9adceaf verified
preview code
|
Raw
History Blame
5.98 kB

virtual-fly

English · 日本語 · 简体中文

virtual-fly 是一个研究项目：以成年雄性果蝇公开的 MaleCNS 连接组作为初始状态，让神经活动、神经调制和局部突触可塑性随时间演化，并与 FlyBody / MuJoCo 身体及物理环境形成闭环。

这个 Hugging Face 仓库用于介绍 virtual-fly，并在同一个仓库中提供四个已发布的检查点。源代码、科学说明、canonical 实验清单以及完整复现脚本位于 GitHub：

获取检查点

四个检查点都可以直接从这个仓库获取。Canonical v1 与历史对比视频所用检查点属于不同系谱。

分发内容 作用 文件
Canonical v1 — 初始 canonical v1 初始状态，global weight version 0 打开
Canonical v1 — 学习后 canonical 六个训练回合之后，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。

检查点

公开检查点分为两个明确不同的系谱。不要把视频用 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。公开前只针对隐私进行历史重写后，公开使用的科学代码等价提交为 f9c86c904d67ff974f3c43d37aab3619bc93fc1b；变化仅限于历史绝对路径中的本地 OS 用户名，可执行源码和 canonical 条件均未改变。这次较短的 canonical 实验中，25,582,938 条存储边里有 2,163,179 条发生了权重变化。但在关闭可塑性和任务触发 DAN 刺激的固定评估中，初始状态和学习后状态的分类结果相同。

因此 canonical v1 证明的是：在当前局部可塑性定义下，保存的 MaleCNS 权重确实发生了变化。它并不声称已经证明了明确的行为改善、泛化能力或长期学习稳定性。

历史 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 包为准。