Metadata-Version: 2.4
Name: ira-connector
Version: 0.1.0
Summary: IRA home connector — discovers ONVIF/RTSP cameras on your LAN and relays motion-gated frames to the IRA cloud over an outbound-only encrypted WebSocket. No port forwarding.
Author: IRA Intelligence (Velvee.ai)
License: Proprietary
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: opencv-python-headless>=4.8
Requires-Dist: websockets>=12
Requires-Dist: numpy>=1.24

# ira-connector

The **IRA home connector** — turns the ONVIF/RTSP cameras on your WiFi into cloud
security intelligence, without exposing anything to the internet.

Runs on any always-on machine (Mac, PC, Raspberry Pi) on the same network as your
cameras. It discovers them (ONVIF WS-Discovery), pulls their RTSP streams locally,
and relays motion-gated frames to your IRA server over **one outbound encrypted
WebSocket**. No port forwarding, no router changes — your cameras are never
reachable from the internet.

## Install & pair

```sh
pipx install ira-connector
ira-connector pair <CODE> --server https://your-ira-server   # code from the IRA app
ira-connector run
```

The pairing code is shown in the IRA app's onboarding ("Link your home"). It is
single-use and expires in 10 minutes.

## What it sends

Only what monitoring needs: ≤960px JPEG frames at ~1 fps while the scene is idle,
bursting to ~8 fps when cheap on-device motion detection sees activity. All
detection intelligence runs server-side.

## Works with

Cameras and NVR/DVR channels that speak **ONVIF/RTSP** — Hikvision, Dahua,
Reolink, Amcrest, Annke, Uniview, and most installer CCTV systems. Cloud-locked
cameras (Ring, Blink, Nest, Arlo) have no local protocol and are not supported.
