This repository aggregates all code, hardware designs, and supporting resources for the Nature Protocols paper: "Drug self-administration in head-fixed mice" by Elizabeth M. Doncheck et al. (2025). For the full protocol, see the published article.
This meta-repository serves as a centralized hub for reproducible implementation of the head-restrained intravenous and oral self-administration protocol in mice. It links to modular components of the REACHER open-source behavioral software stack, custom hardware designs (including 3D-printable parts via Tinkercad), and optimized surgical protocols for catheter implantation.
For detailed step-by-step instructions, refer to the paper's protocol sections on equipment construction, software setup, surgery, and behavioral training.
| Repository | Description |
|---|---|
reacher-firmware |
Low-level drivers for interfacing with custom rigs, solenoids, pumps, and sensors (e.g., Arduino-compatible). |
reacher |
Core server for session management, event logging, and real-time control of self-administration trials. Supports Python-based extensions for custom rewards. |
labrynth |
Pre-built modifiable application. |
reacher-hardware-models |
3D models for various hardware prints. |
For comprehensive installation instructions or customization guides, please refer to the docs folder in this repository.
If using these resources, please cite:
Doncheck, E.M. et al. Drug self-administration in head-fixed mice. Nat. Protoc. (2026). https://doi.org/PLACEHOLDER
Last updated: January 2026