Skip to content

Record a sky camera around the clock, keep the footage on your own disk, and find what flew past.

1.4 KB
Raw Blame

Processor

The Python program that runs detection models for openskycam. It runs on a machine you own, asks the API for work over HTTPS, decodes recordings, runs YOLO models, links detections into tracks, and uploads the results. It never listens for connections.

It needs macOS or Linux with Python 3.11 or later. With device: auto it uses an NVIDIA GPU (CUDA) when there is one, then Apple Silicon (MPS), then the CPU.

cd processor
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python -m skyvision_processor --help

install-workshop.sh installs the Workshop runner and install-model-sync.sh installs model sync, as launchd agents on macOS or systemd user services on Linux. Both take your API origin and a mode-600 key file.

Read For
Processor Installing the runner, registering a runtime, how a job runs, throughput and every command
Models The model registry, publishing a trained model, and model sync
Tracking and trajectories How detections become tracks
Architecture The code layout and its checks

Run the tests with make processor-check from the repository root. On macOS, PyAV and OpenCV can print duplicate AVFoundation class warnings; decoding still completes.