rpi-camera-ensemble 0.4.3__tar.gz

rpi_camera_ensemble-0.4.3/.gitignore

@@ -0,0 +1,168 @@
+# IDE files
+.idea/
+.vscode/
+
+# Ignored file types
+.DS_Store
+*.yaml
+*.json
+
+# Allow test fixtures regardless of extension
+!tests/fixtures/
+!tests/fixtures/**
+!tests/fixtures/**/*.yaml
+!tests/fixtures/**/*.json
+!tests/fixtures/**/*.npz
+!tests/fixtures/**/*.h264
+!tests/fixtures/**/*.csv
+
+# Allow deploy directory
+!deploy/
+!deploy/**
+!deploy/**/*.yaml
+!deploy/**/*.ini
+!deploy/**/*.cfg
+!deploy/**/*.j2
+
+# Allow examples directory
+!examples/
+!examples/**
+!examples/**/*.yaml
+!examples/**/*.json
+!examples/**/*.py
+
+# Custom config files
+*.conf.custom
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# hatch-vcs generated version file — do not track
+src/*/_version.py

rpi_camera_ensemble-0.4.3/CITATION.cff

@@ -0,0 +1,23 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it as below."
+type: software
+title: "rpi-camera-ensemble: Central orchestration of video acquisition across multiple Raspberry Pi cameras"
+version: "0.4.1"
+date-released: "2026-05-30"
+repository-code: https://github.com/MurineShiftWork/rpi-camera-ensemble
+url: https://MurineShiftWork.github.io/rpi-camera-ensemble/
+license: BSD-3-Clause
+authors:
+  - family-names: Rollik
+    given-names: Lars B.
+    email: L.B.Rollik@protonmail.com
+    orcid: https://orcid.org/0000-0003-0160-6971
+
+# Zenodo integration (optional):
+# 1. Enable the Zenodo webhook at zenodo.org/account/settings/github
+# 2. After first tag release, copy the concept DOI from Zenodo and add:
+#
+# identifiers:
+#   - type: doi
+#     value: 10.5281/zenodo.XXXXXXX
+#     description: Zenodo concept DOI

rpi_camera_ensemble-0.4.3/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Lars B. Rollik
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

rpi_camera_ensemble-0.4.3/PKG-INFO

@@ -0,0 +1,289 @@
+Metadata-Version: 2.4
+Name: rpi-camera-ensemble
+Version: 0.4.3
+Summary: RPi Camera Ensemble: Central orchestration of video acquisition across multiple Raspberry Pi cameras.
+Project-URL: Homepage, https://github.com/MurineShiftWork/rpi-camera-ensemble
+Project-URL: Documentation, https://MurineShiftWork.github.io/rpi-camera-ensemble/
+Project-URL: Issue Tracker, https://github.com/MurineShiftWork/rpi-camera-ensemble/issues
+Author-email: "Lars B. Rollik" <L.B.Rollik@protonmail.com>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2025, Lars B. Rollik
+        All rights reserved.
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice, this
+           list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Requires-Dist: numpy
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml
+Requires-Dist: typing-extensions; python_version < '3.11'
+Provides-Extra: agent
+Requires-Dist: fastapi; extra == 'agent'
+Requires-Dist: picamera2; extra == 'agent'
+Requires-Dist: uvicorn[standard]; extra == 'agent'
+Provides-Extra: all
+Requires-Dist: aiohttp; extra == 'all'
+Requires-Dist: fastapi; extra == 'all'
+Requires-Dist: lgpio; extra == 'all'
+Requires-Dist: picamera2; extra == 'all'
+Requires-Dist: uvicorn[standard]; extra == 'all'
+Provides-Extra: conductor
+Requires-Dist: aiohttp; extra == 'conductor'
+Provides-Extra: dev
+Requires-Dist: commitizen; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: types-pyyaml; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material; extra == 'docs'
+Provides-Extra: lgpio
+Requires-Dist: lgpio; extra == 'lgpio'
+Provides-Extra: pigpio
+Requires-Dist: pigpio; extra == 'pigpio'
+Provides-Extra: rpi
+Requires-Dist: fastapi; extra == 'rpi'
+Requires-Dist: lgpio; extra == 'rpi'
+Requires-Dist: picamera2; extra == 'rpi'
+Requires-Dist: uvicorn[standard]; extra == 'rpi'
+Provides-Extra: rpigpio
+Requires-Dist: rpi-gpio; extra == 'rpigpio'
+Description-Content-Type: text/markdown
+
+[//]: # (Badges)
+
+[![CI](https://img.shields.io/github/actions/workflow/status/MurineShiftWork/rpi-camera-ensemble/ci.yml?branch=main&label=CI)](https://github.com/MurineShiftWork/rpi-camera-ensemble/actions)
+[![Docs](https://img.shields.io/github/actions/workflow/status/MurineShiftWork/rpi-camera-ensemble/docs.yml?branch=main&label=docs)](https://MurineShiftWork.github.io/rpi-camera-ensemble/)
+[![PyPI](https://img.shields.io/pypi/v/rpi-camera-ensemble)](https://pypi.org/project/rpi-camera-ensemble/)
+[![License](https://img.shields.io/github/license/MurineShiftWork/rpi-camera-ensemble)](LICENSE)
+
+# RPi Camera Ensemble
+
+Central orchestration of synchronized video acquisition across multiple Raspberry Pi cameras.
+
+Runs a **Conductor** on the acquisition machine that controls one or more **Agents**: each Agent is a FastAPI server running on an individual Raspberry Pi, managing local camera acquisition and GPIO-based TTL synchronization.
+
+---
+
+## Features
+
+- **Multi-camera orchestration**: start/stop all cameras with a single call; UUID-guarded sessions prevent accidental stops
+- **TTL synchronization**: per-frame GPIO pulses (emitter) and edge-detection timestamps (receiver) via `lgpio` (RPi 4 + RPi 5) or legacy `pigpio`
+- **PiCamera2 backend**: uses the modern `libcamera` stack; preview and recording states
+- **REST API on each agent**: `GET /status`, `POST /agent/acquisition/init`, `POST /agent/acquisition/record`, `POST /agent/acquisition/stop`
+- **Heartbeat monitoring**: background health checks with configurable interval
+- **Disk space check**: pre-acquisition guard based on estimated bitrate and free space
+- **CLI**: `rce-agent run/config` entrypoints for systemd or docker-compose deployment
+
+---
+
+## Architecture
+
+```
+Conductor (acquisition machine)
+    │  HTTP via aiohttp
+    ├── AgentClient → Agent (RPi cam01)  →  Acquisition → PiCamera2
+    ├── AgentClient → Agent (RPi cam02)  →  Acquisition → PiCamera2
+    └── AgentClient → Agent (RPi cam03)  →  Acquisition → PiCamera2
+                                                    │
+                                              TTL out pin (lgpio)
+                                              TTL in  pin (lgpio)
+```
+
+---
+
+## Requirements
+
+- Python ≥ 3.10
+- **On each Raspberry Pi**: `picamera2` (system package), `lgpio` (`pip install lgpio`), `libgpiod2` (system package)
+- **On the acquisition machine (Conductor)**: `aiohttp`
+
+---
+
+## Installation
+
+```bash
+# Acquisition machine (Conductor only)
+pip install "rpi-camera-ensemble[conductor]"
+
+# On each Raspberry Pi (Agent + TTL sync)
+pip install "rpi-camera-ensemble[agent,lgpio]"
+```
+
+Install from source:
+
+```bash
+git clone https://github.com/MurineShiftWork/rpi-camera-ensemble.git
+cd rpi-camera-ensemble
+pip install -e ".[agent,lgpio,dev]"
+```
+
+---
+
+## Quick start
+
+### Agent (on each Raspberry Pi)
+
+Create a config file (`agent.yaml`):
+
+```yaml
+instance_name: cam01
+api_host: 0.0.0.0
+api_port: 8000
+data_dir: /data/recordings
+log_dir: /data/logs
+```
+
+Start the agent:
+
+```bash
+rce-agent run --config agent.yaml
+```
+
+Generate a template config:
+
+```bash
+rce-agent config --to-template agent.template.yaml
+```
+
+### Conductor (on the acquisition machine)
+
+```python
+from rpi_camera_ensemble.conductor.conductor import Conductor
+from rpi_camera_ensemble.config.acquisition import EnsembleAcquisitionConfig
+from rpi_camera_ensemble.config.conductor import ConductorConfig
+
+ensemble_cfg = EnsembleAcquisitionConfig.from_yaml("ensemble.yaml")
+conductor_cfg = ConductorConfig(log_dir="/data/logs/conductor")
+
+with Conductor(config=conductor_cfg, ensemble_config=ensemble_cfg) as conductor:
+    conductor.setup_agents()
+    conductor.initialize_acquisition(
+        acquisition_path="/data/recordings/experiment_001",
+        acquisition_name="experiment_001",
+    )
+    conductor.start_preview()
+    conductor.start_recording()
+    # ... recording ...
+    conductor.stop_acquisition()
+```
+
+Ensemble config (`ensemble.yaml`):
+
+```yaml
+agents:
+  cam01:
+    api_url: http://192.168.1.10:8000
+  cam02:
+    api_url: http://192.168.1.11:8000
+```
+
+---
+
+## TTL synchronization
+
+TTL is configured per agent inside `ensemble.yaml` under `camera_config.ttl`. Default backend is `lgpio` (recommended):
+
+```yaml
+agents:
+  cam01:
+    api_url: http://192.168.1.10:8000
+    camera_config:
+      ttl:
+        library: lgpio
+        gpiochip: 0       # RPi 4: 0, RPi 5: 4
+        out_pin: 25       # emits 1 ms pulse on each encoded frame
+        in_pin: 23        # records edge timestamps from external trigger
+        out_duration_us: 1000
+```
+
+`lgpio` requires `libgpiod2` on the Pi:
+
+```bash
+sudo apt install libgpiod2
+pip install lgpio
+```
+
+> **RPi 5 note**: set `gpiochip: 4` (RP1 southbridge). RPi 4 uses `gpiochip: 0`.
+
+---
+
+## Output structure
+
+Each agent writes files named `{basename}.rce.{instance}.{timestamp}.{type}.{ext}`:
+
+```
+/data/recordings/experiment_001/
+├── session.rce.cam01.20260101_120000_000000.video.h264
+├── session.rce.cam01.20260101_120000_000000.ttl_out.npz
+├── session.rce.cam01.20260101_120000_000000.ttl_in.npz
+├── session.rce.cam02.20260101_120000_000000.video.h264
+├── session.rce.cam02.20260101_120000_000000.ttl_out.npz
+└── session.rce.cam02.20260101_120000_000000.ttl_in.npz
+```
+
+Load and validate a session from the acquisition machine:
+
+```python
+from rpi_camera_ensemble.io import RCESession, validate_session
+
+session = RCESession.from_directory("/data/recordings/experiment_001/")
+qc = validate_session(session)
+qc.print_report()
+```
+
+---
+
+## Deployment
+
+See [`deploy/`](https://github.com/MurineShiftWork/rpi-camera-ensemble/tree/main/deploy) for Ansible playbooks to provision Raspberry Pis (apt packages, Python venv, systemd service).
+
+---
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run pre-commit install
+uv run pytest
+```
+
+---
+
+## License
+
+Copyright (c) 2025 Lars B. Rollik. All rights reserved. See [LICENSE](LICENSE).

rpi_camera_ensemble-0.4.3/README.md

@@ -0,0 +1,203 @@
+[//]: # (Badges)
+
+[![CI](https://img.shields.io/github/actions/workflow/status/MurineShiftWork/rpi-camera-ensemble/ci.yml?branch=main&label=CI)](https://github.com/MurineShiftWork/rpi-camera-ensemble/actions)
+[![Docs](https://img.shields.io/github/actions/workflow/status/MurineShiftWork/rpi-camera-ensemble/docs.yml?branch=main&label=docs)](https://MurineShiftWork.github.io/rpi-camera-ensemble/)
+[![PyPI](https://img.shields.io/pypi/v/rpi-camera-ensemble)](https://pypi.org/project/rpi-camera-ensemble/)
+[![License](https://img.shields.io/github/license/MurineShiftWork/rpi-camera-ensemble)](LICENSE)
+
+# RPi Camera Ensemble
+
+Central orchestration of synchronized video acquisition across multiple Raspberry Pi cameras.
+
+Runs a **Conductor** on the acquisition machine that controls one or more **Agents**: each Agent is a FastAPI server running on an individual Raspberry Pi, managing local camera acquisition and GPIO-based TTL synchronization.
+
+---
+
+## Features
+
+- **Multi-camera orchestration**: start/stop all cameras with a single call; UUID-guarded sessions prevent accidental stops
+- **TTL synchronization**: per-frame GPIO pulses (emitter) and edge-detection timestamps (receiver) via `lgpio` (RPi 4 + RPi 5) or legacy `pigpio`
+- **PiCamera2 backend**: uses the modern `libcamera` stack; preview and recording states
+- **REST API on each agent**: `GET /status`, `POST /agent/acquisition/init`, `POST /agent/acquisition/record`, `POST /agent/acquisition/stop`
+- **Heartbeat monitoring**: background health checks with configurable interval
+- **Disk space check**: pre-acquisition guard based on estimated bitrate and free space
+- **CLI**: `rce-agent run/config` entrypoints for systemd or docker-compose deployment
+
+---
+
+## Architecture
+
+```
+Conductor (acquisition machine)
+    │  HTTP via aiohttp
+    ├── AgentClient → Agent (RPi cam01)  →  Acquisition → PiCamera2
+    ├── AgentClient → Agent (RPi cam02)  →  Acquisition → PiCamera2
+    └── AgentClient → Agent (RPi cam03)  →  Acquisition → PiCamera2
+                                                    │
+                                              TTL out pin (lgpio)
+                                              TTL in  pin (lgpio)
+```
+
+---
+
+## Requirements
+
+- Python ≥ 3.10
+- **On each Raspberry Pi**: `picamera2` (system package), `lgpio` (`pip install lgpio`), `libgpiod2` (system package)
+- **On the acquisition machine (Conductor)**: `aiohttp`
+
+---
+
+## Installation
+
+```bash
+# Acquisition machine (Conductor only)
+pip install "rpi-camera-ensemble[conductor]"
+
+# On each Raspberry Pi (Agent + TTL sync)
+pip install "rpi-camera-ensemble[agent,lgpio]"
+```
+
+Install from source:
+
+```bash
+git clone https://github.com/MurineShiftWork/rpi-camera-ensemble.git
+cd rpi-camera-ensemble
+pip install -e ".[agent,lgpio,dev]"
+```
+
+---
+
+## Quick start
+
+### Agent (on each Raspberry Pi)
+
+Create a config file (`agent.yaml`):
+
+```yaml
+instance_name: cam01
+api_host: 0.0.0.0
+api_port: 8000
+data_dir: /data/recordings
+log_dir: /data/logs
+```
+
+Start the agent:
+
+```bash
+rce-agent run --config agent.yaml
+```
+
+Generate a template config:
+
+```bash
+rce-agent config --to-template agent.template.yaml
+```
+
+### Conductor (on the acquisition machine)
+
+```python
+from rpi_camera_ensemble.conductor.conductor import Conductor
+from rpi_camera_ensemble.config.acquisition import EnsembleAcquisitionConfig
+from rpi_camera_ensemble.config.conductor import ConductorConfig
+
+ensemble_cfg = EnsembleAcquisitionConfig.from_yaml("ensemble.yaml")
+conductor_cfg = ConductorConfig(log_dir="/data/logs/conductor")
+
+with Conductor(config=conductor_cfg, ensemble_config=ensemble_cfg) as conductor:
+    conductor.setup_agents()
+    conductor.initialize_acquisition(
+        acquisition_path="/data/recordings/experiment_001",
+        acquisition_name="experiment_001",
+    )
+    conductor.start_preview()
+    conductor.start_recording()
+    # ... recording ...
+    conductor.stop_acquisition()
+```
+
+Ensemble config (`ensemble.yaml`):
+
+```yaml
+agents:
+  cam01:
+    api_url: http://192.168.1.10:8000
+  cam02:
+    api_url: http://192.168.1.11:8000
+```
+
+---
+
+## TTL synchronization
+
+TTL is configured per agent inside `ensemble.yaml` under `camera_config.ttl`. Default backend is `lgpio` (recommended):
+
+```yaml
+agents:
+  cam01:
+    api_url: http://192.168.1.10:8000
+    camera_config:
+      ttl:
+        library: lgpio
+        gpiochip: 0       # RPi 4: 0, RPi 5: 4
+        out_pin: 25       # emits 1 ms pulse on each encoded frame
+        in_pin: 23        # records edge timestamps from external trigger
+        out_duration_us: 1000
+```
+
+`lgpio` requires `libgpiod2` on the Pi:
+
+```bash
+sudo apt install libgpiod2
+pip install lgpio
+```
+
+> **RPi 5 note**: set `gpiochip: 4` (RP1 southbridge). RPi 4 uses `gpiochip: 0`.
+
+---
+
+## Output structure
+
+Each agent writes files named `{basename}.rce.{instance}.{timestamp}.{type}.{ext}`:
+
+```
+/data/recordings/experiment_001/
+├── session.rce.cam01.20260101_120000_000000.video.h264
+├── session.rce.cam01.20260101_120000_000000.ttl_out.npz
+├── session.rce.cam01.20260101_120000_000000.ttl_in.npz
+├── session.rce.cam02.20260101_120000_000000.video.h264
+├── session.rce.cam02.20260101_120000_000000.ttl_out.npz
+└── session.rce.cam02.20260101_120000_000000.ttl_in.npz
+```
+
+Load and validate a session from the acquisition machine:
+
+```python
+from rpi_camera_ensemble.io import RCESession, validate_session
+
+session = RCESession.from_directory("/data/recordings/experiment_001/")
+qc = validate_session(session)
+qc.print_report()
+```
+
+---
+
+## Deployment
+
+See [`deploy/`](https://github.com/MurineShiftWork/rpi-camera-ensemble/tree/main/deploy) for Ansible playbooks to provision Raspberry Pis (apt packages, Python venv, systemd service).
+
+---
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run pre-commit install
+uv run pytest
+```
+
+---
+
+## License
+
+Copyright (c) 2025 Lars B. Rollik. All rights reserved. See [LICENSE](LICENSE).