# kost-t-human/ruvoice-tts architecture

> Architecture diagram of the GitHub repository kost-t-human/ruvoice-tts, 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/kost-t-human/ruvoice-tts
- Repository: https://github.com/kost-t-human/ruvoice-tts

## Overview

RuVoice is an offline Android system TTS engine for Russian. An Android TTS client submits text to the service, which prepares it for speech, synthesizes with Silero, and returns audio; optional English delegation uses another installed engine. Settings expose dictionaries, rules, profiles, and audit tools. The graph reflects README capabilities and the supplied source index; unsampled implementation details and some runtime wiring are intentionally not inferred.

Main entry points: [`app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt`](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt) (TTS service), [`app/src/main/java/ru/kost/ruvoice/Prefs.kt`](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/Prefs.kt) (Preferences), [`app/src/main/java/ru/kost/ruvoice/SileroModels.kt`](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/SileroModels.kt) (Silero inference), [`app/src/main/java/ru/kost/ruvoice/EnglishProxy.kt`](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/EnglishProxy.kt) (English proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_speech["Speech service"]
  node_service["TTS service"]
  node_english_proxy["English proxy<br/>[EnglishProxy.kt]"]
end

subgraph group_text["Text processing"]
  node_normalizer["Text normalization<br/>[Normalizer.kt]"]
  node_replacements["Text replacements<br/>[Replacements.kt]"]
  node_stress["Stress and homographs<br/>[Stress.kt]"]
  node_english_text["English detection<br/>[English.kt]"]
  node_rules["Processing rules<br/>[Rules.kt]"]
end

subgraph group_models["Models and audio"]
  node_models_runtime["Silero inference<br/>[SileroModels.kt]"]
  node_speech_data[("Voice and stress data<br/>[SileroData.kt]")]
  node_stress_binary["Binary dictionaries<br/>[StressBin.kt]"]
  node_audio_tempo["Audio tempo<br/>[Tempo.kt]"]
end

subgraph group_config["Settings and dictionaries"]
  node_settings["Settings UI"]
  node_preferences[("Preferences<br/>[Prefs.kt]")]
  node_profiles[("Voice profiles<br/>[Profiles.kt]")]
  node_dictionaries[("User dictionaries<br/>[Dicts.kt]")]
end

subgraph group_tools_ui["User tools"]
  node_audit["Reading audit<br/>[Audit.kt]"]
  node_audit_ui["Audit interface<br/>[AuditFragment.kt]"]
end

node_tts_client(("TTS client"))
node_other_engine["Installed TTS engine"]

node_tts_client -->|"submits text"| node_service
node_service -->|"normalizes text"| node_normalizer
node_service -->|"applies replacements"| node_replacements
node_service -->|"resolves stress"| node_stress
node_service -->|"detects English"| node_english_text
node_service -->|"uses rules"| node_rules
node_service -->|"runs inference"| node_models_runtime
node_models_runtime -->|"loads data"| node_speech_data
node_models_runtime -->|"reads tables"| node_stress_binary
node_service -->|"adjusts tempo"| node_audio_tempo
node_service -->|"delegates English"| node_english_proxy
node_english_proxy -.->|"sends English text"| node_other_engine
node_service -->|"returns audio"| node_tts_client
node_settings -->|"configures"| node_preferences
node_preferences -->|"uses profiles"| node_profiles
node_preferences -->|"uses dictionaries"| node_dictionaries
node_preferences -->|"configures delegation"| node_english_proxy
node_audit_ui -->|"manages audit"| node_audit
node_audit -->|"audits normalized text"| node_normalizer

click node_service "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt"
click node_english_proxy "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/EnglishProxy.kt"
click node_normalizer "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/text/Normalizer.kt"
click node_replacements "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/text/Replacements.kt"
click node_stress "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/text/Stress.kt"
click node_english_text "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/text/English.kt"
click node_rules "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/text/Rules.kt"
click node_models_runtime "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/SileroModels.kt"
click node_speech_data "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/SileroData.kt"
click node_stress_binary "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/bin/StressBin.kt"
click node_audio_tempo "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/audio/Tempo.kt"
click node_settings "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/SettingsActivity.kt"
click node_preferences "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/Prefs.kt"
click node_profiles "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/Profiles.kt"
click node_dictionaries "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/Dicts.kt"
click node_audit "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/Audit.kt"
click node_audit_ui "https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/AuditFragment.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_service,node_english_proxy,node_tts_client toneBlue
class node_normalizer,node_replacements,node_stress,node_english_text,node_rules toneAmber
class node_models_runtime,node_speech_data,node_stress_binary,node_audio_tempo toneMint
class node_settings,node_preferences,node_profiles,node_dictionaries toneRose
class node_audit,node_audit_ui,node_other_engine toneIndigo
```

## Components

### Speech service

- [TTS service](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt): `app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt`
- [English proxy](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/EnglishProxy.kt): `app/src/main/java/ru/kost/ruvoice/EnglishProxy.kt`

### Text processing

- [Text normalization](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/text/Normalizer.kt): `app/src/main/java/ru/kost/ruvoice/text/Normalizer.kt`
- [Text replacements](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/text/Replacements.kt): `app/src/main/java/ru/kost/ruvoice/text/Replacements.kt`
- [Stress and homographs](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/text/Stress.kt): `app/src/main/java/ru/kost/ruvoice/text/Stress.kt`
- [English detection](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/text/English.kt): `app/src/main/java/ru/kost/ruvoice/text/English.kt`
- [Processing rules](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/text/Rules.kt): `app/src/main/java/ru/kost/ruvoice/text/Rules.kt`

### Models and audio

- [Silero inference](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/SileroModels.kt): `app/src/main/java/ru/kost/ruvoice/SileroModels.kt`
- [Voice and stress data](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/SileroData.kt): `app/src/main/java/ru/kost/ruvoice/SileroData.kt`
- [Binary dictionaries](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/bin/StressBin.kt): `app/src/main/java/ru/kost/ruvoice/bin/StressBin.kt`
- [Audio tempo](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/audio/Tempo.kt): `app/src/main/java/ru/kost/ruvoice/audio/Tempo.kt`

### Settings and dictionaries

- [Settings UI](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/SettingsActivity.kt): `app/src/main/java/ru/kost/ruvoice/SettingsActivity.kt`
- [Preferences](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/Prefs.kt): `app/src/main/java/ru/kost/ruvoice/Prefs.kt`
- [Voice profiles](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/Profiles.kt): `app/src/main/java/ru/kost/ruvoice/Profiles.kt`
- [User dictionaries](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/Dicts.kt): `app/src/main/java/ru/kost/ruvoice/Dicts.kt`

### User tools

- [Reading audit](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/Audit.kt): `app/src/main/java/ru/kost/ruvoice/Audit.kt`
- [Audit interface](https://github.com/kost-t-human/ruvoice-tts/blob/master/app/src/main/java/ru/kost/ruvoice/AuditFragment.kt): `app/src/main/java/ru/kost/ruvoice/AuditFragment.kt`

### Other components

- **TTS client**
- **Installed TTS engine**

## Connections

- TTS client → TTS service: submits text
- TTS service → Text normalization: normalizes text (evidence: `app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt`)
- TTS service → Text replacements: applies replacements (evidence: `app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt`)
- TTS service → Stress and homographs: resolves stress (evidence: `app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt`)
- TTS service → English detection: detects English (evidence: `app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt`)
- TTS service → Processing rules: uses rules (evidence: `app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt`)
- TTS service → Silero inference: runs inference (evidence: `app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt`)
- Silero inference → Voice and stress data: loads data (evidence: `app/src/main/java/ru/kost/ruvoice/SileroModels.kt`)
- Silero inference → Binary dictionaries: reads tables (evidence: `app/src/main/java/ru/kost/ruvoice/SileroModels.kt`)
- TTS service → Audio tempo: adjusts tempo (evidence: `app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt`)
- TTS service → English proxy: delegates English (evidence: `app/src/main/java/ru/kost/ruvoice/SileroTtsService.kt`)
- English proxy → Installed TTS engine: sends English text
- TTS service → TTS client: returns audio
- Settings UI → Preferences: configures (evidence: `app/src/main/java/ru/kost/ruvoice/SettingsActivity.kt`)
- Preferences → Voice profiles: uses profiles (evidence: `app/src/main/java/ru/kost/ruvoice/Prefs.kt`)
- Preferences → User dictionaries: uses dictionaries (evidence: `app/src/main/java/ru/kost/ruvoice/Prefs.kt`)
- Preferences → English proxy: configures delegation (evidence: `app/src/main/java/ru/kost/ruvoice/Prefs.kt`)
- Audit interface → Reading audit: manages audit (evidence: `app/src/main/java/ru/kost/ruvoice/AuditFragment.kt`)
- Reading audit → Text normalization: audits normalized text (evidence: `app/src/main/java/ru/kost/ruvoice/Audit.kt`)
