How nikilesh-garip/echov2 works
Echo is a local acoustic hazard-detection and emergency-response system, with a web interface for mission control, accounts, and emergency contacts. Its core workflow captures microphone and speaker-loopback audio, classifies and temporally validates sounds, applies escalation policy, then alerts contacts through Telegram. The backend also provides authenticated account/contact APIs and real-time telemetry; the frontend presents product pages and dashboard access. The README is empty, so product capabilities are inferred from source descriptions and the feature-page excerpts; unsampled relationships are omitted where their call paths are not shown.
Main entry points: App.tsx Page routing · server.py API and telemetry · yamnet_classifier.py Sound classifier · agent_orchestrator.py Escalation agent
Components 21
Acoustic detection
- Audio capture
audio_ingestion.py - Sound classifier
yamnet_classifier.py - Audio firewall
acoustic_firewall.py
Incident response
- Escalation agent
agent_orchestrator.py - Telegram dispatch
telegram_manager.py
Backend services
- API and telemetry
server.py - Authentication
auth.py - Accounts and contacts
database.py - Mission dashboard
dashboard/app.js
Web experience
- Page routing
frontend/src/App.tsx - Product overview
frontend/src/pages/Home.tsx - Feature showcase
frontend/src/pages/Features.tsx - Emergency contacts
frontend/src/pages/EmergencyContacts.tsx - About page
frontend/src/pages/About.tsx - Dashboard link
frontend/src/pages/DashboardLink.tsx - Navigation
frontend/src/components/Navbar.tsx - Telemetry hook
frontend/src/hooks/useEchoTelemetry.ts
Other components
- User
- Audio devices
- YAMNet model
- Telegram API
Connections 20
- Audio devices → Audio capture: provides audio
- Audio capture → Sound classifier: classifies chunks
audio_ingestion.py - Sound classifier → YAMNet model: runs inference
- Sound classifier → Audio firewall: filters echoes
acoustic_firewall.py - Escalation agent → Telegram dispatch: dispatches alerts
agent_orchestrator.py - Telegram dispatch → Telegram API: sends alerts
telegram_manager.py - Escalation agent → Accounts and contacts: fetches contacts
agent_orchestrator.py - API and telemetry → Escalation agent: triggers dispatch
server.py - API and telemetry → Accounts and contacts: reads and writes
server.py - API and telemetry → Authentication: uses authentication
server.py - API and telemetry → Telegram dispatch: handles pairing
server.py - User → Page routing: browses
frontend/src/App.tsx - Page routing → Product overview: routes to
frontend/src/App.tsx - Page routing → Feature showcase: routes to
frontend/src/App.tsx - Page routing → Emergency contacts: routes to
frontend/src/App.tsx - Page routing → About page: routes to
frontend/src/App.tsx - Page routing → Dashboard link: routes to
frontend/src/App.tsx - Page routing → Navigation: renders
frontend/src/App.tsx - Navigation → Telemetry hook: uses telemetry
frontend/src/components/Navbar.tsx - Dashboard link → Mission dashboard: links to dashboard