Skip to main content
Nightjar is developed in the open at github.com/Snapsonic/nightjar. Issues and pull requests are welcome.

​
Monorepo layout

​
Dev setup

Requires Node 22+ and pnpm.
To run the node itself you also need go2rtc and ffmpeg on your PATH (brew install go2rtc ffmpeg on macOS), or use docker/compose.dev.yml:
One-time: download the object-detection model (~20 MB):
Leave the NIGHTJAR_SUPABASE_* variables unset to develop local-only (the cloud link stays disabled). See the node README for the full module map and internals.

​
Where to start

  • Browse good first issues.
  • The roadmap items — ONVIF discovery, the Nest SDM bridge, configurable detection thresholds — are all open ground.
  • Docs fixes are contributions too; this site lives in docs/.

​
Licensing notes

Contributions are accepted under AGPL-3.0, the project’s license. One deliberate choice worth knowing: the object-detection weights are YOLOX-tiny (Apache-2.0), not Ultralytics YOLO models, whose weights are AGPL and would complicate downstream use. Keep that in mind if you touch the detection stack.