This release is a pre-release and may not be stable for production use.
REACHER — Operant Experiment Control Server
Hardware control, session coordination, and live data capture for Arduino-driven rodent operant behavior experiments.
Written by: Joshua Boquiren
Overview
REACHER runs rodent operant conditioning experiments end to end — it drives the Arduino-based behavioral chamber, records every event as it happens, and exports the session ready for analysis. Paradigms ship as firmware for fixed ratio, progressive ratio, variable interval, omission, and Pavlovian conditioning, each exposing the hardware a self-administration rig actually uses: levers, cue lights and speakers, syringe pumps, lick circuits, and optogenetic laser control. Reinforcement ratios, timing parameters, session limits, and per-board pin assignments are set from the interface, so a rig is reconfigured between subjects without editing or recompiling firmware.
Every lever press, infusion, lick, and cue is timestamped against the trial clock and streamed live to the browser while the session runs, alongside microscope frame timestamps for aligning behavior with calcium imaging. A single host coordinates several chambers at once — each with its own serial port, paradigm, and output file — and hosts on the same network can be paired so one browser drives an entire rig room. Firmware for any paradigm is flashed onto a board directly from the interface, with no separate Arduino toolchain on the experimenter's machine.
Getting Started
pip install reacher2p # from PyPI
pip install reacher2p-3.4.0b1-py3-none-any.whl # from a release wheel
Host setup — installation, pairing, and systemd services — is documented in docs/setup-guide.md; see CONTRIBUTING.md and RELEASING.md for development and release process.
Architecture & Dependencies
| Component | Language | Framework / Libraries |
|---|---|---|
| REST & WebSocket API | Python 3.10+ | FastAPI, Uvicorn, websockets |
| Serial kernel | Python 3.10+ | pyserial |
| Session manager | Python 3.10+ | Python standard library (threading, asyncio) |
| Discovery & pairing | Python 3.10+ | zeroconf, httpx |
| Terminal monitor | Python 3.10+ | Rich, httpx |
| Firmware uploader | Python 3.10+ | avrdude |
| Arduino firmware | C++ (Arduino) | REACHERDevices, arduino-cli (AVR core) |
License
This project is released into the public domain under the Unlicense. See LICENSE for details.
Contact
Joshua Boquiren — thejoshbq@proton.me
1 maintainer
Release files for reacher2p 3.4.0b1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| reacher2p-3.4.0b1.tar.gz | 752.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| reacher2p-3.4.0b1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / reacher2p-3.4.0b1.tar.gz
| Download URL | reacher2p-3.4.0b1.tar.gz |
|---|---|
| Size | 752.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6ab0d671235efc0826156107eae1b2f582c2216b0158fb6d44c566aaa8460ecf
|
|
BLAKE2b-256 checksum How to use checksums |
51130b0068aed6d0e64e2cdcc9b31758229f224c6ad9c982d0c89deaf0cff9c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.
Transparency logRelease files / reacher2p-3.4.0b1-py3-none-any.whl
| Download URL | reacher2p-3.4.0b1-py3-none-any.whl |
|---|---|
| Size | 673.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c20e607837b93c16b7cc1fb3c7d1032c6481d752a6de2eefa296b917ecefb09a
|
|
BLAKE2b-256 checksum How to use checksums |
84113d0b26b12d6e74f156b93aed9529a981bad308a27aeb367d9b89b26f79ea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.
Transparency log
