How ivelytechnologies/se_ively_edge works
Ively Edge SmartEye provisions a camera-connected edge device, then discovers cameras, generates MediaMTX paths, and runs persistent FFmpeg workers that publish streams for local viewing and cloud/AI access. The agent supervises stream health, exposes device health, and reports status to the cloud over WebSocket; WireGuard, OTA, diagnostics, and encrypted credentials provide supporting capabilities. Relationships below use README statements and SOURCE INDEX references; unsampled implementation details are omitted where their wiring is not established.
Main entry points: main.py Agent runtime · pipeline.py Camera config pipeline · worker_reload.py Worker reload · discover.py Camera discovery
Components 23
Provisioning and discovery
- Provision UI
provision-ui/main.py - Camera discovery
agent/camera/discover.py - ONVIF scanning
agent/camera/onvif_scan.py - Camera config pipeline
agent/camera/pipeline.py - Device configuration
agent/config.py
Camera streaming
- MediaMTX config writer
agent/camera/mediamtx_writer.py - MediaMTX
- Worker reload
agent/camera/worker_reload.py - FFmpeg camera workers
agent/camera/camera_worker.py - Stream recovery
agent/camera/stream_recovery.py
Agent operations
- Agent runtime
agent/main.py - Health API
agent/health.py - Metrics collection
agent/metrics.py - Watchdog
agent/watchdog.py
Cloud and security
- Cloud WebSocket
agent/ws_client.py - Cloud command dispatch
agent/commands.py - WireGuard tunnel
agent/wireguard/client.py - WireGuard keys
agent/wireguard/keys.py - Credential vault
agent/security/vault.py - OTA updater
agent/ota/updater.py
Other components
- Device operator
- IP cameras / NVR
- Ively cloud
Connections 32
- Device operator → Provision UI: submits setup
README.md - Provision UI → Ively cloud: registers device
README.md - Provision UI → Camera config pipeline: applies camera config
provision-ui/main.py - Provision UI → Camera discovery: scans cameras
provision-ui/main.py - IP cameras / NVR → Camera discovery: provides camera feeds
README.md - Camera discovery → ONVIF scanning: uses ONVIF scan
agent/camera/discover.py - Camera discovery → Camera config pipeline: provides camera list
agent/camera/discover.py - Camera config pipeline → MediaMTX config writer: generates paths
agent/camera/pipeline.py - Camera config pipeline → Device configuration: uses settings
agent/camera/pipeline.py - Camera config pipeline → MediaMTX: restarts service
agent/camera/pipeline.py - Worker reload → MediaMTX config writer: generates worker configs
agent/camera/worker_reload.py - Worker reload → FFmpeg camera workers: replaces workers
agent/camera/worker_reload.py - Worker reload → MediaMTX: restarts service
agent/camera/worker_reload.py - FFmpeg camera workers → MediaMTX: publishes streams
README.md - Agent runtime → Worker reload: starts workers
agent/main.py - Agent runtime → Stream recovery: runs recovery loop
agent/main.py - Agent runtime → Metrics collection: collects metrics
agent/main.py - Agent runtime → Watchdog: starts watchdog
agent/main.py - Agent runtime → Health API: starts health server
agent/main.py - Agent runtime → Cloud WebSocket: starts cloud connection
agent/main.py - Stream recovery → FFmpeg camera workers: checks and restarts
agent/camera/stream_recovery.py - Stream recovery → MediaMTX: checks path readiness
agent/camera/stream_recovery.py - Health API → Worker reload: routes reload requests
agent/health.py - Health API → Metrics collection: reads metrics
agent/health.py - Cloud WebSocket → Ively cloud: sends heartbeat
README.md - Cloud WebSocket → Cloud command dispatch: dispatches commands
agent/ws_client.py - Cloud command dispatch → WireGuard tunnel: provisions tunnel
agent/commands.py - Cloud command dispatch → OTA updater: runs updates
agent/commands.py - WireGuard tunnel → WireGuard keys: loads keypair
agent/wireguard/client.py - MediaMTX config writer → Credential vault: decrypts credentials
agent/camera/mediamtx_writer.py - Watchdog → Camera discovery: rediscovers cameras
agent/watchdog.py - Watchdog → WireGuard tunnel: checks tunnel
agent/watchdog.py