https://github.com/peyton/braindough
https://github.com/peyton/braindough
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/peyton/braindough
- Owner: peyton
- License: unlicense
- Created: 2026-05-08T07:34:41.000Z (about 1 month ago)
- Default Branch: master
- Last Pushed: 2026-05-08T10:26:20.000Z (about 1 month ago)
- Last Synced: 2026-05-08T12:28:01.556Z (about 1 month ago)
- Language: Python
- Size: 212 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# braindough
`braindough` is a local-first monorepo for brain-modeling experiments. The
first target is Meta/Facebook TRIBE v2, with deterministic fake-backend runs in
CI and heavyweight model/cache/run data kept outside the repository.
## Quick Start
```sh
mise install --locked
just bootstrap
just ci
just run-fake
```
Local heavy data defaults to:
```sh
export BRAINDOUGH_HOME="/Volumes/Virtual Machine HD/Projects/braindough"
```
TRIBE v2 runs are opt-in because they may download large model assets and use
machine-specific acceleration:
```sh
just storage-init
just run-tribe
```
If TRIBE v2 cannot run on the current machine, `run-tribe` writes an explicit
skipped artifact with the blocker instead of failing silently.
## Useful Commands
- `just bootstrap` installs pinned tools, syncs Python deps, and installs hooks.
- `just check` runs formatting checks, lint, type checking, tests, and artifact
validation.
- `just run-fake` runs the CI-safe deterministic smoke experiment.
- `just run-tribe` attempts the first local TRIBE v2 suite.
- `just dataset-bold5000-download` stages BOLD5000 Release 1.0 stimulus-name
metadata and processed ROI response archives under external storage.
- `just run-bold5000-real` runs a bounded real-data BOLD5000 ROI encoding
benchmark using Release 1.0 ROI matrices and stimulus metadata. BOLD5000
Release 2.0 is author-recommended for new functional analyses and remains
future adapter scope.
- `just run-bold5000-preprint-tr34` and `just run-bold5000-preprint-tr3` run
the larger seeded-random BOLD5000 metadata benchmarks used by the preprint
workflow.
- `just run-bold5000-preprint-tr34-grouped-sensitivity` runs a lower-cost
grouped-by-filename split sensitivity for repeated-stimulus leakage checks.
- `just report RUN_DIR=...` rebuilds human-readable reports for an existing run.
See `docs/` for architecture, storage layout, artifact schema, TRIBE v2 notes,
and the experiment backlog.