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

✨ 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

Clone the repository:

git clone https://github.com/yourusername/sakura-sensei.git
cd sakura-sensei

Install dependencies:
```
npm install
```
Set up API Key:
- Get your API key from Google AI Studio.
- Option A (Recommended): Create a .env file in the root directory:
```
VITE_API_KEY=your_gemini_api_key_here
```
- Option B: Enter the key directly in the app's Settings menu.
Run the app:
```
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.

Releases 5

v0.11.1_20251229 Latest

2025-12-29 23:26:08 +08:00

Languages

TypeScript 97.8%

HTML 1.7%

JavaScript 0.3%

Dockerfile 0.2%

README.md Unescape Escape

Sakura Sensei 🌸 - AI Japanese Tutor