██████╗ ██╗ █████╗ ██╗     ███████╗██╗  ██╗████████╗
██╔══██╗██║██╔══██╗██║     ██╔════╝██║ ██╔╝╚══██╔══╝
██║  ██║██║███████║██║     █████╗  █████╔╝    ██║   
██║  ██║██║██╔══██║██║     ██╔══╝  ██╔═██╗    ██║   
██████╔╝██║██║  ██║███████╗███████╗██║  ██╗   ██║   
╚═════╝ ╚═╝╚═╝  ╚═╝╚══════╝╚══════╝╚═╝  ╚═╝   ╚═╝                                                   

"So the Lord scattered them over the face of the whole earth." — Genesis 11:8

An AI-powered language tutor leveraging adaptive CEFR-aligned pedagogy and real-time conversational synthesis.

How it works: Type in either your native language or the target language. The AI tutor always responds in the target language to maintain immersion. When you write in your native language, your message is translated to the target language with phonetics. When you practice in the target language, you receive corrections and guidance. All responses include phonetics and translations to help you understand.

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        User Input Layer                         │
│                  (Native or Target Language)                    │
└────────────────────────────┬────────────────────────────────────┘
                             │
┌─────────────────────────────────────────────────────────────────┐
│                    Phoenix LiveView Layer                       │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────┐   │
│  │  SetupLive   │  │ DashboardLive│  │     ChatLive         │   │
│  │  (Config)    │  │  (Sessions)  │  │  (Conversation)      │   │
│  └──────────────┘  └──────────────┘  └──────────┬───────────┘   │
└─────────────────────────────────────────────────┼───────────────┘
                                                  │
┌─────────────────────────────────────────────────────────────────┐
│                      Business Logic Layer                       │
│  ┌──────────────────────────────┐  ┌────────────────────────┐   │
│  │    Dialekt.Tutor             │  │  Dialekt.Learning      │   │
│  │  • Build CEFR prompts        │  │  • Config schema       │   │
│  │  • Enforce register rules    │  │  • ChatSession schema  │   │
│  │  • Parse AI responses        │  │  • Persistence layer   │   │
│  │  • Generate starters         │  │                        │   │
│  └────────────┬─────────────────┘  └────────────────────────┘   │
└───────────────┼─────────────────────────────────────────────────┘
                │
                ▼
┌─────────────────────────────────────────────────────────────────┐
│                     HTTP Client Layer (ReqLLM)                  │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────┐   │
│  │  Anthropic   │  │   OpenAI     │  │    OpenRouter        │   │
│  │  Claude 3.5  │  │  GPT-4/4o    │  │  (Multiple models)   │   │
│  └──────────────┘  └──────────────┘  └──────────────────────┘   │
└────────────────────────────┬────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────────┐
│                  Structured Response Format                     │
│  • You: [phrase + IPA + transliteration]                        │
│  • Note: [corrections in native language]                       │
│  • Tutor: [response in target + translation]                    │
│  • Follow-up: [question to continue]                            │
│  • Tips: [learning insights]                                    │
└────────────────────────────┬────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────────┐
│                      PostgreSQL Database                        │
│  • User configurations (languages, CEFR level, register)        │
│  • Chat sessions and message history                            │
└─────────────────────────────────────────────────────────────────┘

Features

• Adaptive Conversations - Vocabulary and grammar adjust to your CEFR level (A1-C2)
• Multi-Language Support - 70+ languages including English, Spanish, French, German, Mandarin, Japanese, Portuguese, Arabic, Russian, Hindi
• Multiple LLM Providers - Choose between Anthropic, OpenAI, or OpenRouter
• Contextual Feedback - Real-time corrections, translations, IPA phonetics
• Text-to-Speech - Native pronunciation synthesis for all supported languages
• Voice Input - Browser-based speech-to-text with support for both native and target languages
• Session Management - Save and resume configurations

Quick Start

# Start PostgreSQL
docker compose -f dockercompose.yml up -d

# Install dependencies (versions in .tool-versions)
asdf install && mix deps.get

# Configure environment
cp .env.example .env  # Add API key for your chosen provider (Anthropic/OpenAI/OpenRouter)

# Setup and run
mix ecto.setup && mix phx.server

Visit localhost:4000

Using Voice Input

Dialekt supports browser-based speech-to-text for hands-free language practice:

1. Start recording - Click the microphone button next to the text input
2. Switch languages - Click the language badge (e.g., "DE" or "EN") that appears while recording to toggle between your native and target language
3. Speak naturally - The waveform visualizes your voice input in real-time
4. Stop recording - Click the stop button or simply finish speaking (recognition ends automatically)
5. Review transcript - Your speech is transcribed and appears in the text input for you to review before sending

Notes:

• Voice input uses the Web Speech API (requires internet connection)
• Supports 70+ languages with varying quality depending on browser support
• Works best in Chrome/Brave (may require disabling privacy shields for localhost)
• Recognition accuracy depends on microphone quality, accent, and language