# manthansachdev12/hackwave_pragyan architecture

> Architecture diagram of the GitHub repository manthansachdev12/hackwave_pragyan, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/manthansachdev12/hackwave_pragyan
- Repository: https://github.com/manthansachdev12/hackwave_pragyan

## Overview

The main product is a municipal citizen-services voice assistant, with a Streamlit call dashboard, a LiveKit voice agent, and a token endpoint. Its documented service areas and complaint workflow are represented, but the dashboard currently simulates calls and complaints rather than connecting audio to the agent. A separate Django project is configured for SQLite and exposes an admin route; the sampled code does not show municipal application behavior there. Edges reflect shown calls, configuration, or documented behavior; the token-server implementation and Django app views were not sampled.

Main entry points: [`municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py) (Voice Session), [`municipal-voice-ai-live/Hackwave_pragyan/app.py`](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/app.py) (Call Dashboard), [`djnago/munciple/munciple/urls.py`](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/djnago/munciple/munciple/urls.py) (Admin Routing), [`djnago/munciple/munciple/settings.py`](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/djnago/munciple/munciple/settings.py) (Project Settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Citizen Dashboard"]
  node_dashboard["Call Dashboard<br/>[app.py]"]
  node_call_ui["Call Controls<br/>[app.py]"]
  node_service_catalog["Service Catalog<br/>[app.py]"]
  node_complaint_history["Complaint History<br/>[app.py]"]
end

subgraph group_voice["Voice Assistant"]
  node_token_server["Token Endpoint<br/>[token_server.py]"]
  node_livekit{{"LiveKit Rooms"}}
  node_agent_runtime["Agent Runtime<br/>[municipal_agent.py]"]
  node_voice_session["Voice Session<br/>[municipal_agent.py]"]
  node_vad["Voice Detection<br/>[municipal_agent.py]"]
  node_speech_recognition["Speech Recognition<br/>[municipal_agent.py]"]
  node_gemini["Gemini Responses<br/>[municipal_agent.py]"]
  node_speech_synthesis["Speech Synthesis<br/>[municipal_agent.py]"]
  node_complaint_handling["Complaint Handling<br/>[municipal_agent.py]"]
end

subgraph group_django["Django Project"]
  node_django_urls["Admin Routing<br/>[urls.py]"]
  node_django_settings["Project Settings<br/>[settings.py]"]
  node_django_admin{{"Django Admin"}}
  node_sqlite[("SQLite Database<br/>[db.sqlite3]")]
end

node_citizen(("Citizen"))

node_citizen -->|"uses"| node_dashboard
node_dashboard -->|"renders"| node_call_ui
node_dashboard -->|"renders"| node_service_catalog
node_dashboard -->|"renders"| node_complaint_history
node_call_ui -->|"requests token"| node_token_server
node_agent_runtime -->|"starts"| node_voice_session
node_voice_session -->|"configures"| node_vad
node_voice_session -->|"configures"| node_speech_recognition
node_voice_session -->|"configures"| node_gemini
node_voice_session -->|"configures"| node_speech_synthesis
node_agent_runtime -->|"connects through"| node_livekit
node_agent_runtime -->|"implements"| node_complaint_handling
node_django_urls -->|"routes to"| node_django_admin
node_django_settings -->|"configures"| node_sqlite

click node_dashboard "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/app.py"
click node_call_ui "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/app.py"
click node_service_catalog "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/app.py"
click node_complaint_history "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/app.py"
click node_token_server "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/token_server.py"
click node_agent_runtime "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py"
click node_voice_session "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py"
click node_vad "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py"
click node_speech_recognition "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py"
click node_gemini "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py"
click node_speech_synthesis "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py"
click node_complaint_handling "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py"
click node_django_urls "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/djnago/munciple/munciple/urls.py"
click node_django_settings "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/djnago/munciple/munciple/settings.py"
click node_sqlite "https://github.com/manthansachdev12/hackwave_pragyan/blob/main/djnago/munciple/db.sqlite3"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_call_ui,node_service_catalog,node_complaint_history toneBlue
class node_token_server,node_livekit,node_agent_runtime,node_voice_session,node_vad,node_speech_recognition,node_gemini,node_speech_synthesis,node_complaint_handling toneAmber
class node_django_urls,node_django_settings,node_django_admin,node_sqlite toneMint
class node_citizen toneIndigo
```

## Components

### Citizen Dashboard

- [Call Dashboard](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/app.py): `municipal-voice-ai-live/Hackwave_pragyan/app.py`
- [Call Controls](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/app.py): `municipal-voice-ai-live/Hackwave_pragyan/app.py`
- [Service Catalog](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/app.py): `municipal-voice-ai-live/Hackwave_pragyan/app.py`
- [Complaint History](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/app.py): `municipal-voice-ai-live/Hackwave_pragyan/app.py`

### Voice Assistant

- [Token Endpoint](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/token_server.py): `municipal-voice-ai-live/Hackwave_pragyan/token_server.py`
- **LiveKit Rooms**
- [Agent Runtime](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py): `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`
- [Voice Session](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py): `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`
- [Voice Detection](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py): `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`
- [Speech Recognition](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py): `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`
- [Gemini Responses](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py): `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`
- [Speech Synthesis](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py): `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`
- [Complaint Handling](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py): `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`

### Django Project

- [Admin Routing](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/djnago/munciple/munciple/urls.py): `djnago/munciple/munciple/urls.py`
- [Project Settings](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/djnago/munciple/munciple/settings.py): `djnago/munciple/munciple/settings.py`
- **Django Admin**
- [SQLite Database](https://github.com/manthansachdev12/hackwave_pragyan/blob/main/djnago/munciple/db.sqlite3): `djnago/munciple/db.sqlite3`

### Other components

- **Citizen**

## Connections

- Citizen → Call Dashboard: uses (evidence: `municipal-voice-ai-live/Hackwave_pragyan/app.py`)
- Call Dashboard → Call Controls: renders (evidence: `municipal-voice-ai-live/Hackwave_pragyan/app.py`)
- Call Dashboard → Service Catalog: renders (evidence: `municipal-voice-ai-live/Hackwave_pragyan/app.py`)
- Call Dashboard → Complaint History: renders (evidence: `municipal-voice-ai-live/Hackwave_pragyan/app.py`)
- Call Controls → Token Endpoint: requests token (evidence: `municipal-voice-ai-live/Hackwave_pragyan/app.py`)
- Agent Runtime → Voice Session: starts (evidence: `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`)
- Voice Session → Voice Detection: configures (evidence: `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`)
- Voice Session → Speech Recognition: configures (evidence: `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`)
- Voice Session → Gemini Responses: configures (evidence: `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`)
- Voice Session → Speech Synthesis: configures (evidence: `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`)
- Agent Runtime → LiveKit Rooms: connects through (evidence: `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`)
- Agent Runtime → Complaint Handling: implements (evidence: `municipal-voice-ai-live/Hackwave_pragyan/municipal_agent.py`)
- Admin Routing → Django Admin: routes to (evidence: `djnago/munciple/munciple/urls.py`)
- Project Settings → SQLite Database: configures (evidence: `djnago/munciple/munciple/settings.py`)
