# malecns-weights

Ledger for **MaleCNS v1.0 compiled wiring**.

This is not a living fly, not an upload, and not a 166k-parameter LLM. Almost all of the graph is **evolutionary anatomy**. The only plastic object this repo will store is a **mushroom-body adapter** (KC→MBON). Whole-graph SGD is refused.

Claims live in [kvnloo/frontier-kb](https://github.com/kvnloo/frontier-kb):

- `perm-20260912-connectome-is-wiring-not-a-trainable-llm`
- `perm-20260912-mushroom-body-is-the-only-plastic-specialist`
- `perm-20260912-anatomy-is-init-not-a-faithful-brain`
- `lit-20260912-shiu-huang-malecns-physiology`
- `lit-20260912-fly-connectome-task-meme`

fly-wirehead already said the arrays should be consumed from a **separate package**. This is that package. It does not run a LIF kernel and does not own Hermes recovery.

## What is pinned

| Layer | What | Mutable? |
| --- | --- | --- |
| Janelia feathers | annotations / transmitters / 1.05 GiB edges (`sources.lock`) | no |
| Compiled arrays | CSR `ptr`/`post`/`weight` + cell maps from fly-wirehead | no |
| `kc_to_mbon_wirehead` | 7,835 existing KC→MBON07/11 edges (~0.03% of 25,582,938) | adapter only |
| `kc_to_mbon_motif` | evolution-lab Hermes student (`W_kc_mbon`; PN→KC stays frozen). **Not MaleCNS.** | adapter only |

Census: **166,700** neurons, **25,582,938** directed edges, CC BY 4.0, [MaleCNS v1.0](https://male-cns.janelia.org/download/).

```sh
pip install -e .
```

## Mushroom body

Only KC→MBON is plastic. PAM11 (15) / PPL101 (2) teach MBON07 (4) / MBON11 (2). Huang 2024 centered rate-rule, η=0.001, existing edges only. Frozen flag holds `u,w`.

Live bytes are **not** in git. They sit next to the SLMs:

`/mnt/zer0models/zer0-models/malecns/`

| Path | What |
| --- | --- |
| `adapters/hermes-mb-motif/` | evolution-lab KC→MBON student (480 weights). Not MaleCNS. |
| `adapters/kc-to-mbon-wirehead/` | 7,835-edge template until the CSR is fetched |
| `cache/` | Janelia feathers / compiled arrays |
| `zer0-models/qwen`, `gguf`, `ollama` | SLMs (untouched). Qwen stays the language worker. |

```sh
python -m malecns_weights mb setup
python -m malecns_weights mb status
python -m malecns_weights sgd          # exit 2, always
```

`MALECNS_WEIGHTS_ROOT` overrides the store. `fetch` writes feathers into `$ROOT/cache`.

## Join

| Repo | Owns | Does not own |
| --- | --- | --- |
| **this** | hashes, frozen-vs-plastic policy, adapter copies | LIF kernel, gym, claims |
| [fly-wirehead](https://github.com/kvnloo/fly-wirehead) | MaleCNS LIF playback, PAM11 assay | learning result |
| [evolution-lab](https://github.com/kvnloo/evolution-lab) | Hermes `local_plasticity` student (480 KC→MBON on current champion) | MaleCNS arrays |
| [frontier-kb](https://github.com/kvnloo/frontier-kb) | literature / permanents | runtime |

## License

MIT for this ledger. MaleCNS data remains **CC BY 4.0** (FlyEM / HHMI Janelia et al.). See [THIRD_PARTY.md](THIRD_PARTY.md).