Language Configuration

All language settings are centralized in edgevox/core/config.py.

LanguageConfig

Each language is defined by a LanguageConfig dataclass:

@dataclass(frozen=True)
class LanguageConfig:
    code: str           # ISO 639-1 code ("en", "vi", "fr")
    name: str           # Display name ("English", "Vietnamese")
    stt_backend: str    # "whisper", "sherpa", or "chunkformer"
    tts_backend: str    # "kokoro", "piper", "supertonic", or "pythaitts"
    kokoro_lang: str    # Kokoro lang code ("a", "b", "e", "f", ...)
    default_voice: str  # Default TTS voice name
    test_phrase: str    # Warm-up phrase for TTS
    whisper_lang: str   # Override for Whisper language code

API

get_lang(code: str) -> LanguageConfig

Get config by language code. Returns English config for unknown codes.

from edgevox.core.config import get_lang

cfg = get_lang("ja")
cfg.name           # "Japanese"
cfg.kokoro_lang    # "j"
cfg.default_voice  # "jf_alpha"
cfg.test_phrase    # "Konnichiwa."

cfg = get_lang("ko")
cfg.tts_backend    # "supertonic"
cfg.default_voice  # "ko-F1"

lang_options() -> list[tuple[str, str]]

Returns (display_name, code) tuples for UI selectors.

from edgevox.core.config import lang_options

for name, code in lang_options():
    print(f"{code}: {name}")

needs_stt_reload(old_code, new_code) -> bool

Check if switching languages requires a new STT model.

from edgevox.core.config import needs_stt_reload

needs_stt_reload("en", "fr")  # False (both use Whisper)
needs_stt_reload("en", "vi")  # True (Whisper → Sherpa)

LANGUAGES: dict[str, LanguageConfig]

Dictionary of all registered languages.

Adding a Language

# In edgevox/core/config.py

_reg(LanguageConfig(
    code="tr",              # ISO code
    name="Turkish",          # Display name
    stt_backend="whisper",   # STT backend
    tts_backend="kokoro",    # TTS backend
    kokoro_lang="a",         # Kokoro lang (or "a" for English fallback)
    default_voice="af_heart",# Default voice
    test_phrase="Merhaba.",  # Warmup text
))

The language is immediately available in the TUI, Web UI, CLI, and all factories.