🎓 LinguaMaster AI

World-Class Real-Time AI Language Tutor
Gerçek Zamanlı, İleri Seviye Yapay Zeka Dil Öğretmeni

🇬🇧 English | 🇹🇷 Türkçe

---

🇬🇧 English

LinguaMaster AI is a cutting-edge language learning application powered by Google's Gemini Models. It offers a hybrid learning experience combining text-based chat and low-latency Real-Time Voice (Live API) interaction to help users achieve fluency.

🌟 Key Features

• 🗣️ Gemini Live Session: Engage in natural, real-time voice conversations with low latency. The AI listens, understands, and responds instantly with human-like intonation.
• 🎭 Roleplay Scenarios: Immerse yourself in real-world scenarios. Practice ordering coffee, checking into a hotel, or a job interview with an AI that stays in character.
• 🤖 Adaptive Personas: Choose your tutor's personality:
  • Strict Professor: Focuses on grammar precision.
  • Friendly Local: Uses slang and casual language.
  • Business Coach: Professional tone for career skills.
  • Encouraging Friend: Supportive and patient.
• 📝 Smart Corrections & Hints: Receive immediate feedback on your grammar and vocabulary. Stuck? Ask for hints generated in real-time.
• 📚 Vocabulary Notebook: Select any text in the chat to listen to its pronunciation and save it to your personal vocabulary list.
• 🎧 Text-to-Speech (TTS): High-quality, natural-sounding voice output for all messages.

🛠️ Tech Stack

• Frontend: React 19, TypeScript, Vite
• AI Core: Google GenAI SDK (@google/genai)
  • Models: gemini-2.5-flash-native-audio-preview, gemini-3-flash-preview
• Styling: Tailwind CSS, Lucide React Icons
• Audio: Web Audio API (for visualizers and PCM processing)

🚀 Installation & Setup

1. Clone the repository:

   git clone https://github.com/gkhantyln/linguamaster-ai.git
   cd linguamaster-ai

2. Install dependencies:

   npm install

3. Configure API Key: Create a .env file in the root directory and add your Google Gemini API key:

   GEMINI_API_KEY=your_api_key_here

4. Run the application:

   npm run dev

---

🇹🇷 Türkçe

LinguaMaster AI, Google Gemini Modelleri tarafından desteklenen son teknoloji bir dil öğrenme uygulamasıdır. Kullanıcıların akıcılık kazanmasına yardımcı olmak için metin tabanlı sohbeti ve düşük gecikmeli Gerçek Zamanlı Ses (Live API) etkileşimini birleştiren hibrit bir öğrenme deneyimi sunar.

🌟 Temel Özellikler

• 🗣️ Gemini Canlı Oturum (Live Session): Doğal, gerçek zamanlı sesli konuşmalar yapın. Yapay zeka sizi dinler, anlar ve insan benzeri tonlamalarla anında yanıt verir.
• 🎭 Rol Yapma Senaryoları (Roleplay): Kendinizi gerçek dünya senaryolarına bırakın. Bir kafede sipariş verme, otele giriş yapma veya iş görüşmesi gibi durumları karakterden çıkmayan bir yapay zeka ile pratik yapın.
• 🤖 Uyarlanabilir Karakterler: Öğretmeninizin kişiliğini seçin:
  • Disiplinli Profesör: Dilbilgisi doğruluğuna odaklanır.
  • Samimi Yerli: Argo ve günlük dil kullanır.
  • İş Koçu: Kariyer becerileri için profesyonel ton.
  • Destekleyici Arkadaş: Sabırlı ve motive edici.
• 📝 Akıllı Düzeltmeler ve İpuçları: Dilbilgisi ve kelime seçimleriniz hakkında anında geri bildirim alın. Takıldınız mı? Anında ipucu isteyin.
• 📚 Kelime Defteri: Sohbetteki herhangi bir metni seçerek telaffuzunu dinleyin ve kişisel kelime defterinize kaydedin.
• 🎧 Metin Okuma (TTS): Tüm mesajlar için yüksek kaliteli, doğal seslendirme.

🛠️ Teknolojiler

• Önyüz: React 19, TypeScript, Vite
• Yapay Zeka: Google GenAI SDK (@google/genai)
  • Modeller: gemini-2.5-flash-native-audio-preview, gemini-3-flash-preview
• Stil: Tailwind CSS, Lucide React Icons
• Ses: Web Audio API (görselleştiriciler ve PCM işleme için)

🚀 Kurulum

1. Projeyi klonlayın:

   git clone https://github.com/gkhantyln/linguamaster-ai.git
   cd linguamaster-ai

2. Bağımlılıkları yükleyin:

   npm install

3. API Anahtarını Ayarlayın: Ana dizinde bir .env dosyası oluşturun ve Google Gemini API anahtarınızı ekleyin:

   GEMINI_API_KEY=api_anahtariniz_buraya

4. Uygulamayı çalıştırın:

   npm run dev

---

👨‍💻 Developer / Geliştirici

Gökhan Taylan

Built with ❤️ using Gemini API