# krkunal404/nav-indus-sih-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/krkunal404/nav-indus-sih-2026
- Repository: https://github.com/krkunal404/nav-indus-sih-2026

## Overview

Nimo is a native Android voice companion for older users. Its documented main flow is wake-word detection or typed input into a floating overlay, followed by assistant interaction; MainActivity requests permissions and wires callbacks. The README documents the overlay, wake-word, and keyboard-input relationships. Other substantial speech, LLM, action, and notification modules appear in the source tree, but their runtime wiring was not shown, so they are represented without guessed connections.

Main entry points: [`MyApp/app/src/main/java/com/example/myapp/overlay/WakeWordManager.kt`](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/WakeWordManager.kt) (Wake-word manager), [`MyApp/app/src/main/java/com/example/myapp/overlay/OverlayService.kt`](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/OverlayService.kt) (Overlay service), [`MyApp/app/src/main/java/com/example/myapp/overlay/Queryinputactivity.kt`](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/Queryinputactivity.kt) (Query input activity), [`MyApp/app/src/main/java/com/example/myapp/MainActivity.kt`](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/MainActivity.kt) (Main activity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_main["Main activity<br/>[MainActivity.kt]"]
  node_splash["Splash activity<br/>[SplashActivity.kt]"]
end

subgraph group_overlay["Overlay interaction"]
  node_controller["Overlay controller"]
  node_service["Overlay service<br/>[OverlayService.kt]"]
  node_wake["Wake-word manager<br/>[WakeWordManager.kt]"]
  node_query["Query input activity"]
  node_activevoice["Active voice input"]
  node_applaunch["App launch activity"]
end

subgraph group_speech["Speech capabilities"]
  node_vosk["Vosk voice manager"]
  node_whisper["Groq Whisper"]
  node_language["Language manager<br/>[LanguageManager.kt]"]
  node_contacts["Contact vocabulary"]
  node_tts["Text to speech<br/>[TTSManager.kt]"]
end

subgraph group_assistant["Assistant features"]
  node_nimo["Nimo LLM<br/>[NimoLLM.kt]"]
  node_actions["Action executor<br/>[ActionExecutor.kt]"]
  node_alarms["Alarm manager<br/>[AlarmManager.kt]"]
  node_calls["Call manager<br/>[CallManager.kt]"]
  node_emergency["Emergency manager"]
  node_health["Health manager<br/>[HealthManager.kt]"]
  node_messages["Message manager<br/>[MessageManager.kt]"]
  node_notifications["WhatsApp notifications"]
end

node_user(("User"))
node_androidspeech{{"Android SpeechRecognizer"}}

node_user -->|"speaks wake phrase"| node_wake
node_wake -->|"listens with"| node_androidspeech
node_wake -->|"shows overlay"| node_service
node_user -->|"uses panel"| node_service
node_user -->|"taps input"| node_query
node_service -->|"opens for typing"| node_query
node_main -->|"uses overlay API"| node_controller

click node_main "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/MainActivity.kt"
click node_splash "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/SplashActivity.kt"
click node_controller "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/OverlayController.kt"
click node_service "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/OverlayService.kt"
click node_wake "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/WakeWordManager.kt"
click node_query "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/Queryinputactivity.kt"
click node_activevoice "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/ActiveVoiceInput.kt"
click node_applaunch "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/AppLaunchActivity.kt"
click node_vosk "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/speech/VoskVoiceManager.kt"
click node_whisper "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/speech/GroqWhisperManager.kt"
click node_language "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/speech/LanguageManager.kt"
click node_contacts "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/speech/ContactVocabularySupplier.kt"
click node_tts "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/speech/TTSManager.kt"
click node_nimo "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/NimoLLM.kt"
click node_actions "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/ActionExecutor.kt"
click node_alarms "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/AlarmManager.kt"
click node_calls "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/CallManager.kt"
click node_emergency "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/EmergencyManager.kt"
click node_health "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/HealthManager.kt"
click node_messages "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/MessageManager.kt"
click node_notifications "https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/notifications/WhatsAppNotificationListener.kt"

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_main,node_splash,node_user toneBlue
class node_controller,node_service,node_wake,node_query,node_activevoice,node_applaunch toneAmber
class node_vosk,node_whisper,node_language,node_contacts,node_tts toneMint
class node_nimo,node_actions,node_alarms,node_calls,node_emergency,node_health,node_messages,node_notifications toneRose
class node_androidspeech toneIndigo
```

## Components

### App entry

- [Main activity](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/MainActivity.kt): `MyApp/app/src/main/java/com/example/myapp/MainActivity.kt`
- [Splash activity](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/SplashActivity.kt): `MyApp/app/src/main/java/com/example/myapp/SplashActivity.kt`

### Overlay interaction

- [Overlay controller](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/OverlayController.kt): `MyApp/app/src/main/java/com/example/myapp/overlay/OverlayController.kt`
- [Overlay service](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/OverlayService.kt): `MyApp/app/src/main/java/com/example/myapp/overlay/OverlayService.kt`
- [Wake-word manager](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/WakeWordManager.kt): `MyApp/app/src/main/java/com/example/myapp/overlay/WakeWordManager.kt`
- [Query input activity](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/Queryinputactivity.kt): `MyApp/app/src/main/java/com/example/myapp/overlay/Queryinputactivity.kt`
- [Active voice input](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/ActiveVoiceInput.kt): `MyApp/app/src/main/java/com/example/myapp/overlay/ActiveVoiceInput.kt`
- [App launch activity](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/overlay/AppLaunchActivity.kt): `MyApp/app/src/main/java/com/example/myapp/overlay/AppLaunchActivity.kt`

### Speech capabilities

- [Vosk voice manager](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/speech/VoskVoiceManager.kt): `MyApp/app/src/main/java/com/example/myapp/speech/VoskVoiceManager.kt`
- [Groq Whisper](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/speech/GroqWhisperManager.kt): `MyApp/app/src/main/java/com/example/myapp/speech/GroqWhisperManager.kt`
- [Language manager](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/speech/LanguageManager.kt): `MyApp/app/src/main/java/com/example/myapp/speech/LanguageManager.kt`
- [Contact vocabulary](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/speech/ContactVocabularySupplier.kt): `MyApp/app/src/main/java/com/example/myapp/speech/ContactVocabularySupplier.kt`
- [Text to speech](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/speech/TTSManager.kt): `MyApp/app/src/main/java/com/example/myapp/speech/TTSManager.kt`

### Assistant features

- [Nimo LLM](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/NimoLLM.kt): `MyApp/app/src/main/java/com/example/myapp/llm/NimoLLM.kt`
- [Action executor](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/ActionExecutor.kt): `MyApp/app/src/main/java/com/example/myapp/llm/ActionExecutor.kt`
- [Alarm manager](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/AlarmManager.kt): `MyApp/app/src/main/java/com/example/myapp/llm/AlarmManager.kt`
- [Call manager](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/CallManager.kt): `MyApp/app/src/main/java/com/example/myapp/llm/CallManager.kt`
- [Emergency manager](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/EmergencyManager.kt): `MyApp/app/src/main/java/com/example/myapp/llm/EmergencyManager.kt`
- [Health manager](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/HealthManager.kt): `MyApp/app/src/main/java/com/example/myapp/llm/HealthManager.kt`
- [Message manager](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/llm/MessageManager.kt): `MyApp/app/src/main/java/com/example/myapp/llm/MessageManager.kt`
- [WhatsApp notifications](https://github.com/krkunal404/nav-indus-sih-2026/blob/main/MyApp/app/src/main/java/com/example/myapp/notifications/WhatsAppNotificationListener.kt): `MyApp/app/src/main/java/com/example/myapp/notifications/WhatsAppNotificationListener.kt`

### Other components

- **User**
- **Android SpeechRecognizer**

## Connections

- User → Wake-word manager: speaks wake phrase (evidence: `README.md`)
- Wake-word manager → Android SpeechRecognizer: listens with (evidence: `README.md`)
- Wake-word manager → Overlay service: shows overlay (evidence: `README.md`)
- User → Overlay service: uses panel (evidence: `README.md`)
- User → Query input activity: taps input (evidence: `README.md`)
- Overlay service → Query input activity: opens for typing (evidence: `README.md`)
- Main activity → Overlay controller: uses overlay API (evidence: `README.md`)
