How kerberos-io/agent works
Kerberos Agent is an edge video-surveillance agent: it connects to a camera, processes its feed for motion-based or continuous recording, and makes recordings available through a web interface. Users configure and inspect the agent through the UI and its API; the backend also exposes live streaming, camera control, and cloud integrations. The excerpts establish key startup, routing, capture, and UI relationships; several cloud and storage internals were not sampled, so those capabilities are shown at subsystem level without speculative call chains.
Main entry points: routes.go HTTP API · capture/main.go Capture and record · websocket/main.go WebSocket streaming · App.jsx Agent web UI
Components 19
Agent runtime
- Agent startup
machinery/main.go - Configuration
machinery/src/config/main.go - Camera controls
machinery/src/components - ONVIF control
machinery/src/onvif/main.go
Video processing
- Capture and record
machinery/src/capture/main.go - Motion detection
machinery/src/computervision/main.go - Media packets
machinery/src/packets - WebRTC streaming
machinery/src/webrtc/main.go
User interfaces
- HTTP API
machinery/src/routers/http/routes.go - WebSocket streaming
machinery/src/routers/websocket/main.go - MQTT remote access
machinery/src/routers/mqtt/main.go - Agent web UI
ui/src/App.jsx - Dashboard and settings
ui/src/pages/Settings/Settings.jsx - UI actions
ui/src/actions/agent.js - UI API client
ui/src/api/agent.js - UI state
ui/src/reducers/agent.js
Cloud integrations
- Cloud and storage
machinery/src/cloud
Other components
- Operator
- RTSP camera
Connections 21
- Operator → Agent web UI: uses
- Agent web UI → Dashboard and settings: routes to
ui/src/index.jsx - Agent web UI → UI actions: dispatches
ui/src/App.jsx - UI actions → UI API client: calls
ui/src/actions/agent.js - UI actions → UI state: updates
- UI API client → HTTP API: requests
- Agent startup → Configuration: loads
machinery/src/config/main.go - Agent startup → HTTP API: starts
machinery/main.go - HTTP API → Camera controls: routes controls
machinery/src/routers/http/routes.go - HTTP API → WebSocket streaming: routes stream
machinery/src/routers/http/routes.go - HTTP API → ONVIF control: routes control
machinery/src/routers/http/routes.go - RTSP camera → Capture and record: provides feed
README.md - Capture and record → Media packets: uses
machinery/src/capture/main.go - Capture and record → Motion detection: detects motion
- Capture and record → Cloud and storage: uploads recordings
README.md - WebSocket streaming → Capture and record: streams camera
machinery/src/routers/websocket/main.go - WebSocket streaming → WebRTC streaming: uses
- MQTT remote access → WebRTC streaming: registers candidates
machinery/src/routers/mqtt/main.go - MQTT remote access → Capture and record: connects camera
machinery/src/routers/mqtt/main.go - Operator → HTTP API: accesses
README.md - HTTP API → Cloud and storage: verifies storage
machinery/src/routers/http/routes.go