# sumit5-si/itantra architecture

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

- Interactive diagram: https://gitdiagram.com/sumit5-si/itantra
- Repository: https://github.com/sumit5-si/itantra

## Overview

iTantra is an offline-first Android peer-to-peer voice communicator. Its documented sender-to-receiver flow captures speech, detects speech activity, transcribes locally, translates text, sends a compact packet over Wi-Fi Direct or Bluetooth, then speaks the received text locally. The app also provides discovery, emergency alerts, and local message history. The source index and excerpts support the app wiring, transport selection, voice engines, and persistence; translation is a documented capability, but no translation source path appears in the supplied tree, so it is not represented as an implementation node.

Main entry points: [`app/src/main/java/com/itantra/app/communication/transport/ConnectionManager.kt`](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/communication/transport/ConnectionManager.kt) (Connection manager), [`app/src/main/java/com/itantra/app/ITantraApplication.kt`](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ITantraApplication.kt) (App composition), [`app/src/main/java/com/itantra/app/navigation/ITantraNavGraph.kt`](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/navigation/ITantraNavGraph.kt) (Navigation), [`app/src/main/java/com/itantra/app/ui/home/HomeScreen.kt`](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ui/home/HomeScreen.kt) (Home controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and UI"]
  node_activity["Android entry<br/>[MainActivity.kt]"]
  node_navigation["Navigation<br/>[ITantraNavGraph.kt]"]
  node_home["Home controls<br/>[HomeScreen.kt]"]
  node_homevm["Home state<br/>[HomeViewModel.kt]"]
  node_scan["Peer discovery UI"]
  node_communicate["Conversation UI"]
end

subgraph group_voice["Voice processing"]
  node_capture["Audio capture"]
  node_vad["Speech detection"]
  node_stt["Offline transcription"]
  node_features["Audio cleanup"]
  node_tts["Voice playback"]
end

subgraph group_link["Peer communication"]
  node_manager["Connection manager"]
  node_wifi["Wi-Fi Direct<br/>[WifiTransport.kt]"]
  node_bluetooth["Bluetooth RFCOMM"]
  node_serializer["Packet serializer"]
  node_packet["Message packet<br/>[MessagePacket.kt]"]
  node_service["Communication service"]
end

subgraph group_history["Local history"]
  node_repository["Message repository"]
  node_dao["Message DAO<br/>[MessageDao.kt]"]
  node_database[("Conversation database<br/>[ITantraDatabase.kt]")]
end

subgraph group_foundation["Core services"]
  node_application["App composition"]
  node_language["Language preferences<br/>[LanguageManager.kt]"]
end

node_user(("User"))

node_user -->|"opens app"| node_activity
node_activity -->|"hosts"| node_navigation
node_navigation -.->|"routes to"| node_home
node_navigation -.->|"routes to"| node_scan
node_navigation -.->|"routes to"| node_communicate
node_home -->|"observes state"| node_homevm
node_user -->|"controls"| node_home
node_home -->|"requests discovery"| node_scan
node_homevm -.->|"uses links"| node_manager
node_application -->|"initializes"| node_language
node_application -->|"provides transports"| node_manager
node_application -->|"creates"| node_repository
node_application -->|"opens"| node_database
node_capture -.->|"feeds audio"| node_vad
node_vad -->|"gates transcription"| node_stt
node_stt -.->|"uses cleanup"| node_features
node_stt -->|"provides text"| node_manager
node_manager -->|"dispatches"| node_wifi
node_manager -->|"dispatches"| node_bluetooth
node_wifi -->|"parses packets"| node_serializer
node_bluetooth -->|"uses packets"| node_serializer
node_serializer -->|"encodes"| node_packet
node_manager -->|"starts service"| node_service
node_manager -.->|"stores messages"| node_repository
node_repository -->|"reads and writes"| node_dao
node_dao -.->|"queries"| node_database
node_manager -->|"delivers received text"| node_tts
node_user -->|"speaks"| node_capture

click node_activity "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/MainActivity.kt"
click node_navigation "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/navigation/ITantraNavGraph.kt"
click node_home "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ui/home/HomeScreen.kt"
click node_homevm "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ui/home/HomeViewModel.kt"
click node_scan "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ui/scan/ScanNearbyScreen.kt"
click node_communicate "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ui/communication/CommunicationScreen.kt"
click node_capture "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/voice/audio/AndroidAudioCaptureManager.kt"
click node_vad "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/voice/vad/TFLiteNeuralVADEngine.kt"
click node_stt "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/voice/stt/OfflineSTTEngineImpl.kt"
click node_features "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/voice/stt/PyTorchAcousticFeatureEngine.kt"
click node_tts "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/voice/tts/AndroidTTSEngine.kt"
click node_manager "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/communication/transport/ConnectionManager.kt"
click node_wifi "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/communication/wifi/WifiTransport.kt"
click node_bluetooth "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/communication/bluetooth/BluetoothTransport.kt"
click node_serializer "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/communication/packet/PacketSerializer.kt"
click node_packet "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/domain/model/MessagePacket.kt"
click node_service "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/communication/service/ITantraCommunicationService.kt"
click node_application "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ITantraApplication.kt"
click node_language "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/core/localization/LanguageManager.kt"
click node_repository "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/data/repository/MessageRepositoryImpl.kt"
click node_dao "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/data/local/MessageDao.kt"
click node_database "https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/data/local/ITantraDatabase.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_activity,node_navigation,node_home,node_homevm,node_scan,node_communicate,node_user toneBlue
class node_capture,node_vad,node_stt,node_features,node_tts toneAmber
class node_manager,node_wifi,node_bluetooth,node_serializer,node_packet,node_service toneMint
class node_repository,node_dao,node_database toneRose
class node_application,node_language toneIndigo
```

## Components

### App and UI

- [Android entry](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/MainActivity.kt): `app/src/main/java/com/itantra/app/MainActivity.kt`
- [Navigation](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/navigation/ITantraNavGraph.kt): `app/src/main/java/com/itantra/app/navigation/ITantraNavGraph.kt`
- [Home controls](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ui/home/HomeScreen.kt): `app/src/main/java/com/itantra/app/ui/home/HomeScreen.kt`
- [Home state](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ui/home/HomeViewModel.kt): `app/src/main/java/com/itantra/app/ui/home/HomeViewModel.kt`
- [Peer discovery UI](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ui/scan/ScanNearbyScreen.kt): `app/src/main/java/com/itantra/app/ui/scan/ScanNearbyScreen.kt`
- [Conversation UI](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ui/communication/CommunicationScreen.kt): `app/src/main/java/com/itantra/app/ui/communication/CommunicationScreen.kt`

### Voice processing

- [Audio capture](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/voice/audio/AndroidAudioCaptureManager.kt): `app/src/main/java/com/itantra/app/voice/audio/AndroidAudioCaptureManager.kt`
- [Speech detection](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/voice/vad/TFLiteNeuralVADEngine.kt): `app/src/main/java/com/itantra/app/voice/vad/TFLiteNeuralVADEngine.kt`
- [Offline transcription](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/voice/stt/OfflineSTTEngineImpl.kt): `app/src/main/java/com/itantra/app/voice/stt/OfflineSTTEngineImpl.kt`
- [Audio cleanup](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/voice/stt/PyTorchAcousticFeatureEngine.kt): `app/src/main/java/com/itantra/app/voice/stt/PyTorchAcousticFeatureEngine.kt`
- [Voice playback](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/voice/tts/AndroidTTSEngine.kt): `app/src/main/java/com/itantra/app/voice/tts/AndroidTTSEngine.kt`

### Peer communication

- [Connection manager](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/communication/transport/ConnectionManager.kt): `app/src/main/java/com/itantra/app/communication/transport/ConnectionManager.kt`
- [Wi-Fi Direct](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/communication/wifi/WifiTransport.kt): `app/src/main/java/com/itantra/app/communication/wifi/WifiTransport.kt`
- [Bluetooth RFCOMM](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/communication/bluetooth/BluetoothTransport.kt): `app/src/main/java/com/itantra/app/communication/bluetooth/BluetoothTransport.kt`
- [Packet serializer](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/communication/packet/PacketSerializer.kt): `app/src/main/java/com/itantra/app/communication/packet/PacketSerializer.kt`
- [Message packet](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/domain/model/MessagePacket.kt): `app/src/main/java/com/itantra/app/domain/model/MessagePacket.kt`
- [Communication service](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/communication/service/ITantraCommunicationService.kt): `app/src/main/java/com/itantra/app/communication/service/ITantraCommunicationService.kt`

### Local history

- [Message repository](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/data/repository/MessageRepositoryImpl.kt): `app/src/main/java/com/itantra/app/data/repository/MessageRepositoryImpl.kt`
- [Message DAO](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/data/local/MessageDao.kt): `app/src/main/java/com/itantra/app/data/local/MessageDao.kt`
- [Conversation database](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/data/local/ITantraDatabase.kt): `app/src/main/java/com/itantra/app/data/local/ITantraDatabase.kt`

### Core services

- [App composition](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/ITantraApplication.kt): `app/src/main/java/com/itantra/app/ITantraApplication.kt`
- [Language preferences](https://github.com/sumit5-si/itantra/blob/main/app/src/main/java/com/itantra/app/core/localization/LanguageManager.kt): `app/src/main/java/com/itantra/app/core/localization/LanguageManager.kt`

### Other components

- **User**

## Connections

- User → Android entry: opens app (evidence: `app/src/main/java/com/itantra/app/MainActivity.kt`)
- Android entry → Navigation: hosts (evidence: `app/src/main/java/com/itantra/app/MainActivity.kt`)
- Navigation → Home controls: routes to (evidence: `app/src/main/java/com/itantra/app/navigation/ITantraNavGraph.kt`)
- Navigation → Peer discovery UI: routes to (evidence: `app/src/main/java/com/itantra/app/navigation/ITantraNavGraph.kt`)
- Navigation → Conversation UI: routes to (evidence: `app/src/main/java/com/itantra/app/navigation/ITantraNavGraph.kt`)
- Home controls → Home state: observes state (evidence: `app/src/main/java/com/itantra/app/ui/home/HomeScreen.kt`)
- User → Home controls: controls (evidence: `README.md`)
- Home controls → Peer discovery UI: requests discovery (evidence: `app/src/main/java/com/itantra/app/ui/home/HomeScreen.kt`)
- Home state → Connection manager: uses links
- App composition → Language preferences: initializes (evidence: `app/src/main/java/com/itantra/app/ITantraApplication.kt`)
- App composition → Connection manager: provides transports (evidence: `app/src/main/java/com/itantra/app/ITantraApplication.kt`)
- App composition → Message repository: creates (evidence: `app/src/main/java/com/itantra/app/ITantraApplication.kt`)
- App composition → Conversation database: opens (evidence: `app/src/main/java/com/itantra/app/ITantraApplication.kt`)
- Audio capture → Speech detection: feeds audio
- Speech detection → Offline transcription: gates transcription (evidence: `README.md`)
- Offline transcription → Audio cleanup: uses cleanup
- Offline transcription → Connection manager: provides text (evidence: `README.md`)
- Connection manager → Wi-Fi Direct: dispatches (evidence: `app/src/main/java/com/itantra/app/communication/transport/ConnectionManager.kt`)
- Connection manager → Bluetooth RFCOMM: dispatches (evidence: `app/src/main/java/com/itantra/app/communication/transport/ConnectionManager.kt`)
- Wi-Fi Direct → Packet serializer: parses packets (evidence: `app/src/main/java/com/itantra/app/communication/wifi/WifiTransport.kt`)
- Bluetooth RFCOMM → Packet serializer: uses packets (evidence: `app/src/main/java/com/itantra/app/communication/bluetooth/BluetoothTransport.kt`)
- Packet serializer → Message packet: encodes (evidence: `app/src/main/java/com/itantra/app/communication/packet/PacketSerializer.kt`)
- Connection manager → Communication service: starts service (evidence: `app/src/main/java/com/itantra/app/communication/transport/ConnectionManager.kt`)
- Connection manager → Message repository: stores messages
- Message repository → Message DAO: reads and writes (evidence: `app/src/main/java/com/itantra/app/data/repository/MessageRepositoryImpl.kt`)
- Message DAO → Conversation database: queries
- Connection manager → Voice playback: delivers received text (evidence: `README.md`)
- User → Audio capture: speaks (evidence: `README.md`)
