Enter master key for instant admin access — no password needed
Two-Factor
6-digit code sent to your alert email
Reset Password
Enter your username to receive OTP
Master Key Required
Enter your master key to unlock the logs for this session
GARUDA
Initializing
GARUDA
Alert
All Clear
Night Presence
—
Offline
◯
Camera feed unavailable
-- fps
Alert Activity
13 weeks · local
FewerMore
System Console
LIVE CAMERA
Speak a command to begin
Quick Commands
Groq Free Plan · Rate Limits
TierModelReq/minReq/dayTok/minTok/day
LOWllama-3.1-8b-instant3014,4006K500K
MEDllama-3.3-70b-versatile301,00012K100K
HIGHopenai/gpt-oss-120b301,0008K200K
Higher tiers are smarter but have smaller daily quotas. Switch to Low for casual use.
Hi, I'm Narada — your AI security assistant. I have full context on your detection pipeline, system modes, alert history, and hardware. Ask me anything or give me a command.
Enter to send · Shift+Enter for newline
Email Settings
Gmail App Password required. Go to myaccount.google.com → Security → App Passwords to generate one.
Sender Gmail
App Password
Alert Recipients (comma-separated)
Alert Cooldown (seconds)
System Settings
Security Health
All OK
✓
Watchdog Timer
Heartbeat active
✓
Camera Feed
Feed normal
✓
Thermal Control
Temperature normal
✓
Network
Connected
✓
Storage
OK
✓
Event Queue
Online — no pending events
Detection
Detection Threshold — 0.30
SensitiveStrict
Danger Label (object that triggers alert)
Privacy
Face Privacy Blur
Blur detected persons in the feed
Known Devices (Owner Detection)
iPhone users: iOS randomizes your MAC by default. To use your real MAC:
Open Settings → Wi-Fi
Tap the ⓘ next to your home network
Turn off Private Wi-Fi Address
Reconnect, then tap ⓘ again — copy the Wi-Fi Address shown there
Required for Narada voice assistant. Get a free key at console.groq.com.
Watch Labels (log only, no alert)
Comma-separated YOLO class names to silently log (no alert triggered).
Night Presence Alarm (yellow alert)
Yellow alarm fires when a person is detected in this IST time window. Leave times blank or disable to turn off.
Enable Night Presence Alarm
Windowto
Scheduled Modes (auto-activate by time)
Leave start/end blank to disable scheduling for that mode.
Nightto
DNDto
Idleto
Master Keys
Master keys grant instant admin access and unlock the logs page.
Step 1 — Verify identity
Step 2 — Enter OTP from email
Step 3 — Create a new key
Logs
Custom Commands
Teach Narada new phrases. Say the phrase out loud and she responds with your custom message.
Phrase
Response
New Command
Phrase Narada listens for
Response
Connect to Backend
The Garuda backend runs on your Raspberry Pi. Enter its address below
(e.g. http://192.168.1.100:8080
or a Cloudflare Tunnel URL).
Backend URL
Documentation
Garuda system overview and reference
Garuda Security System
Garuda is a full-stack AI security console built for Raspberry Pi 5 and Hailo-8L. It combines live detection, mode control, owner presence, admin operations, Narada AI assistance, logs, and feedback in one interface.
Main Surfaces
1 Sign in
→
2 Dashboard
→
3 Narada / Chat
→
4 Admin tools
What the app includes
Live camera and floor plan views, Dynamic Island system states, alert history heatmap, activity timeline, recent detections, voice quick commands, LLM chat, email alerts, known-device presence detection, logs export, custom Narada phrases, master-key access, and a server-side feedback inbox for admin.
Dashboard
Live monitoring
The dashboard is the main operational view. It shows the current security state, live uptime, last alert time, threshold, pipeline status, and owner-home status.
Center stage
The camera card supports Live and Floor Plan tabs. Below it, the Alert Activity heatmap visualizes detections over recent weeks.
Side panels
The left column exposes System Modes and Hub Health for CPU, RAM, temperature, FPS, and disk. The right column shows the date-filtered Activity timeline and Recent Detections.
Dynamic Island
The top Dynamic Island reflects key real-time states such as alerts, all clear, Narada activity, and chat thinking, so the app status remains visible across pages.
Detection and Alerting
Pipeline
YOLOv6n runs on the Hailo-8L and processes camera frames in real time. Detected classes above the configured confidence threshold are evaluated against alert rules and watch rules.
Alert Logic
1 Object detected
→
2 Matches danger label?
→
3 Trigger alert
→
4 Send email
Detection controls
Danger Label defines the object that triggers an alert. Watch Labels are logged silently without escalating. Detection Threshold controls model sensitivity from 0.05 to 0.95.
Operational modes
Privacy Blur obscures faces, Night Mode increases alert readiness, DND suppresses disturbances, Idle changes system behavior for standby, Email Alerts Off disables email delivery, and Emergency overrides quieter modes.
Narada Assistant
Voice page
The Narada page is optimized for quick spoken control. It presents voice activity output and one-tap quick commands for common mode changes such as DND, Night, Emergency, Idle, and Privacy.
Chat page
The dedicated chat interface supports natural-language requests. Narada can answer questions about the pipeline, settings, hardware, and recent app context, and can also execute supported control commands.
Configuration
Narada uses a Groq API key configured in admin settings. The UI also includes a model/rate-limit explainer so operators understand quota limits for different LLM tiers.
Custom commands
Admins can teach Narada additional phrases and canned responses from the Custom Commands page. These become reusable voice/chat shortcuts inside the app.
Admin Controls
Email Settings
Configure the sender Gmail account, app password, recipients, and alert cooldown. A built-in Send Test Email action validates delivery from the UI.
System Settings
The admin settings page includes security-health checks, detection threshold, danger label, privacy toggle, known-device management, Groq API key storage, watch labels, and master-key administration.
Known Devices
Owner presence is tracked using known MAC addresses. The app includes network scanning helpers and mobile-device guidance for private/random MAC settings.
Logs and exports
The logs page separates System, Detection, Presence, and Voice logs. Admins can filter the current session, export the session log, or download the full combined log archive.
Feedback
The feedback widget stores submissions on the server only. Normal users can submit feedback, while admins can review the inbox from the app. Feedback is persisted on disk with backup recovery.
Access and Security
Login flows
1 Credentials
→
2 OTP via email
→
3 Session token
Users sign in with username and password. Admins authenticate with credentials plus OTP. Master Keys can grant instant admin access and are also used to unlock the logs area.
Session Management
Sessions expire after 1 hour (admin) or 5 days (user with "Remember me"). Tokens are stored as HTTP-only cookies for same-origin requests and in localStorage for cross-origin access.
Additional safeguards
The app enforces per-IP rate limits on sensitive routes, keeps admin-only endpoints protected, and separates public data from privileged settings and logs.
Technology Stack
Hailo-8L13 TOPS neural processor for real-time AI inference
Raspberry Pi 5Quad-core Arm Cortex-A76 @ 2.4GHz host
YOLOv6nLightweight object detection model optimized for edge
GStreamerMedia pipeline for camera capture and processing
FastAPIAsync Python web framework with WebSocket support
WebSockets + SSEReal-time state and streamed chat updates in the UI
GroqExternal LLM provider for Narada voice and chat intelligence
Local JSON persistenceServer-side storage for users, config, logs, alert history, and feedback
Cloudflare TunnelSecure remote access without port forwarding
Frontend capabilities
The web UI includes theme switching, a responsive dashboard, mobile-adapted bottom navigation, interactive logs, an AI chat shell, and live status surfaces coordinated with the backend state.