# Sakura Sensei 🌸 - AI Japanese Tutor
**Sakura Sensei** is a next-generation language learning platform powered by Google's state-of-the-art **Gemini 3** and **Veo** models. It transcends traditional learning apps by offering a context-aware AI tutor, real-time pronunciation scoring, and generative media tools to create a truly immersive Japanese learning environment.
[English](#english) | [日本語](#japanese) | [中文](#chinese)
---
## 🇬🇧 English
### ✨ Key Features
#### 🗣️ Tutor Dojo (Context-Aware Chat)
* **Dual-Model Intelligence:** Switch instantly between **Gemini 3 Flash** (Fast & Responsive) and **Gemini 3 Pro** (Deep Reasoning) directly within the chat interface.
* **Deep Context:** The AI remembers your conversation history, allowing for natural, flowing dialogue and follow-up corrections.
* **Thinking Mode:** Visualize the AI's "thought process" as it breaks down complex grammar rules or cultural nuances before answering.
* **Multimodal Input:** Chat via text, voice (speech-to-text), or by uploading images for analysis.
#### 🎭 Roleplay (Speaking Practice)
* **Real-world Scenarios:** Practice checking into a hotel, ordering at a konbini, or passing immigration.
* **AI Audio Feedback:** Receive instant, actionable feedback on your pronunciation, intonation, and grammar.
* **Native TTS:** High-fidelity Japanese Text-to-Speech powered by Gemini.
#### 📜 Reading Hall & 🎧 Listening Lab
* **Custom Lesson Generation:** Generate unique reading materials and listening scripts tailored exactly to your JLPT level (N5–N1) and interests.
* **Interactive Study:** Click to translate, hear pronunciations, or ask the tutor specific questions about the generated content.
* **Comprehension Quizzes:** Test your understanding with AI-generated quizzes.
#### 🎨 Creative Atelier
* **Visual Learning:** Generate images using **Imagen 3** to visualize vocabulary.
* **Video Immersion:** Create short, AI-generated videos using **Veo** to see cultural concepts in motion.
#### 🧰 Toolbox
* **OCR Scanner:** Snap a photo of a textbook or menu; the AI extracts the text, translates it, and explains the grammar.
* **Smart Translator:** Context-aware translation for text and images.
---
### 🚀 Getting Started
1. **Clone the repository:**
```bash
git clone https://github.com/yourusername/sakura-sensei.git
cd sakura-sensei
```
2. **Install dependencies:**
```bash
npm install
```
3. **Set up API Key:**
* Get your API key from [Google AI Studio](https://aistudio.google.com/).
* **Option A (Recommended):** Create a `.env` file in the root directory:
```env
VITE_API_KEY=your_gemini_api_key_here
```
* **Option B:** Enter the key directly in the app's **Settings** menu.
4. **Run the app:**
```bash
npm run dev
```
### 🛠 Tech Stack
* **Core:** React 19, TypeScript, Vite
* **Styling:** Tailwind CSS, Lucide React, Framer Motion-style CSS animations
* **AI SDK:** `@google/genai`
* **Models:**
* **Reasoning:** `gemini-3-pro-preview` / `gemini-3-flash-preview`
* **Speech:** `gemini-2.5-flash-preview-tts`
* **Vision:** `gemini-3-flash-preview` (OCR/Multimodal)
* **Image Generation:** `imagen-4.0-generate-001`
* **Image Editing:** `gemini-2.5-flash-image`
* **Video Generation:** `veo-3.1-fast-generate-preview`
---
## 🇯🇵 日本語
**さくら先生**は、Googleの最新Geminiモデル（Gemini 3 / Veo）を搭載した、没入型の日本語学習プラットフォームです。文脈を理解するAIとの会話、発音のリアルタイム分析、そして生成AIによる教材作成機能で、あなたの日本語学習を加速させます。
### ✨ 主な機能
* **学習道場 (チャット):**
* 文脈を記憶するAIチューターと自然な会話が可能。
* **モデル切り替え機能:** 高速な `Gemini 3 Flash` と、深い推論を行う `Gemini 3 Pro` を用途に合わせて選択可能。
* **Thinking Mode:** 複雑な文法解説を行う際、AIの思考プロセスを可視化。
* **会話道場 (ロールプレイ):**
* カフェ、駅、ホテルなど、リアルな場面での会話練習。
* 発音や文法ミスに対する即時フィードバック。
* **読書の間 & 聴解ラボ:**
* トピックと難易度（N5〜N1）を指定して、あなただけの教材を自動生成。
* 理解度クイズや、テキストに関する質疑応答機能付き。
* **アトリエ:**
* `Imagen 3` による画像生成や `Veo` による動画生成で、視覚的に単語を記憶。
* **ツールボックス:**
* **OCRスキャナー:** カメラで撮影した日本語テキストを瞬時に分析・解説。
---
## 🇨🇳 中文
**樱花老师 (Sakura Sensei)** 是一款基于 Google 最新 Gemini 3 和 Veo 模型的下一代 AI 日语学习助手。它具备上下文记忆功能，提供深度推理、发音纠正以及多模态生成工具，为您打造身临其境的日语学习体验。
### ✨ 主要功能
* **学习道场 (智能对话):**
* **双模型支持:** 在聊天界面直接切换 `Gemini 3 Flash` (极速) 和 `Gemini 3 Pro` (深度推理)。
* **上下文记忆:** AI 能够记住之前的对话内容，提供连贯的辅导。
* **思维链模式:** 可视化 AI 的思考过程，深度解析复杂语法。
* **对话道场 (角色扮演):**
* 模拟真实场景（如便利店、机场入境），提供实时语音评分与建议。
* **阅读室 & 听力实验室:**
* 根据您的 JLPT 等级 (N5-N1) 和兴趣，一键生成专属的阅读文章和听力测试。
* **创意工作室:**
* 利用 `Imagen` 生成助记图片，或使用 `Veo` 生成短视频辅助学习。
* **实用工具箱:**
* **OCR 扫描:** 拍照识别日语文本，自动生成生词本和语法解析。
---
## License
MIT License.
Powered by [Google Gemini API](https://ai.google.dev/).