EchoPerfect 🌙 - AI Phonetic Coach

EchoPerfect は、Googleの最新AIモデル Gemini 3 Flash を活用した、リアルタイム英語発音矯正アプリです。 「月ねこAI」がプロデュースする、クールで少し辛口なパーソナルコーチング体験を提供します。

📸 Screen Shot

✨ Key Features

• Real-time Analysis: ユーザーの発音を即座に解析し、100点満点でスコアリング。
• Pinpoint Advice: 「舌の位置」や「唇の動き」まで、物理的な改善点を具体的に指摘。
• Native Shadowing: 任意のテキストを入力し、AI生成音声（Native）と聞き比べが可能。
• Moon Cat Coach: 月ねこAIキャラクターによる、親しみやすくも的確なサポート。
• Phrase Library: 定番フレーズや自分の履歴からワンタップで練習を開始できるライブラリ機能。

🛠️ Tech Stack

This project uses a hybrid architecture for speed and scalability.

• Frontend: Next.js 14 (App Router), Tailwind CSS, Lucide React
• Backend: Python 3.9+ with FastAPI
• AI Model: Google Gemini 3 Flash (Preview)
• Speech Synthesis: gTTS (Google Text-to-Speech)
• Deployment: Vercel (Serverless Functions)

📂 Project Structure

echoperfect/
├── api/                  # Python Backend (FastAPI)
│   ├── index.py          # Main application entry point
│   └── ...
├── app/                  # Frontend Application (Next.js)
│   ├── components/       # UI Components (Recorder, Player, Modal)
│   ├── page.tsx          # Main Page Logic
│   └── ...
├── public/               # Static Assets (Images, Icons)
├── next.config.mjs       # Next.js Configuration
├── requirements.txt      # Python Dependencies
└── vercel.json           # Vercel Deployment Config

🚀 Getting Started

Prerequisites

• Node.js: v18 or higher
• Python: v3.9 or higher
• Google Gemini API Key: Get it here

Installation

1. Clone the repo

   git clone https://github.com/your-username/echoperfect.git
   cd echoperfect

2. Setup Backend (Python) It is recommended to use a virtual environment.

   # Create virtual environment
   python -m venv venv
   
   # Activate (Windows)
   .\venv\Scripts\activate
   # Activate (Mac/Linux)
   # source venv/bin/activate
   
   # Install dependencies
   pip install -r requirements.txt

3. Setup Frontend (Node.js)

   npm install

4. Environment Variables Create a .env file in the root directory and add your API key:

   GOOGLE_API_KEY=your_gemini_api_key_here

5. Run Development Server This command starts both the Next.js frontend and FastAPI backend concurrently.

   npm run dev

   • Frontend: http://localhost:3000
   • Backend API: http://localhost:3000/api/* (Rewrites handled by Next.js/Vercel)

🌙 About "Moon Cat AI" (Tsukineko AI)

Produced by 月ねこAI (Moon Cat AI). We are exploring the possibilities of Generative AI and Web Marketing.

---

© 2025 EchoPerfect - Created for the future of language learning.