Your AI-powered gateway to Japan's top companies
Simulate. Score. Succeed.
🌌 What is MIRU?
MIRU (ミル — to see, to observe) is a full-stack AI interview simulator built for non-native candidates preparing for Japanese corporate interviews. It's not just a chatbot — it's a cultural mirror that shows you exactly how a Toyota, Rakuten, or Sony HR interviewer sees you.
You speak. MIRU listens. It scores your answers across 5 deep cultural dimensions, channels the HR persona of your chosen company, and delivers a forensic debrief that pinpoints exactly where you shone — and where you slipped.
"Practice until the interview feels like a conversation, not a test."
✨ Features at a Glance
| Feature | Description |
|---|
| 🎙️ Voice-Driven Interview | Speak naturally — MIRU listens via Web Speech API with auto silence detection |
| 🤖 AI HR Avatar | Animated interviewer that reacts to your speech state in real time |
| 🏢 5 Company Personas | Toyota, Rakuten, Sony, SoftBank, Uniqlo — each with unique cultural DNA |
| 📊 Live Cultural Scoring | 5 Japanese HR dimensions scored turn-by-turn as you speak |
| 🔊 Text-to-Speech | ElevenLabs-powered multilingual interviewer voice (EN + JP) |
| 📡 Real-time Feedback | Instant radar chart, score bars, and HR debrief post-interview |
| 📄 CV Integration | Personalize the interview by uploading your resume |
| 🧠 Coaching Debrief | Per-question feedback + rewritten better answers |
| 🖨️ Print Report | Download your full analysis as a PDF |
🗺️ App Architecture & Flow
┌─────────────────────────────────────────────────────────────────┐
│ 🏠 LANDING (/) │
│ Hero · Feature Highlights · Company Cards → /onboarding │
└──────────────────────────┬──────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 📋 ONBOARDING (/onboarding) │
│ │
│ Step 1 ──► Name + Target Role │
│ Step 2 ──► Company Selection │
│ [Toyota] [Rakuten] [Sony] [SoftBank] [Uniqlo] │
│ Step 3 ──► CV Upload · Language Mode · Duration │
│ │
│ [START INTERVIEW] ──► POST /api/session/start │
│ ──► stores in sessionStorage (saiko_*) │
│ ──► navigate /interview │
└──────────────────────────┬──────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 🎙️ INTERVIEW (/interview) │
│ │
│ State Machine: │
│ IDLE → STARTING → QUESTION → LISTENING → TRANSCRIBING │
│ ▲ │ │
│ │ ▼ │
│ WRAP_UP ◄── WAITING_RESPONSE ◄────────────── │
│ │ │
│ ▼ │
│ COMPLETED ──► /debrief?session_id=... │
│ │
│ Components: │
│ • HRAvatar — state-aware animated interviewer │
│ • VoiceInput — mic button + 20-bar waveform │
│ • Chat Display — scrolling Q&A transcript │
│ • Live Scores — 5-dimension score cards │
│ • Timer — countdown / elapsed │
└──────────────────────────┬──────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 📊 DEBRIEF (/debrief) │
│ │
│ Polls backend → waits for debrief_ready │
│ │
│ Section A — Radar Chart (Candidate vs Ideal) │
│ Section B — 5 Score Bars (color-coded) │
│ Section C — Interviewer Feedback (strengths + improvements) │
│ Section D — Coaching Breakdown (per-question analysis) │
│ Section E — Hiring Signal (Hire / Borderline / No Hire) │
│ Section F — CTA (Practice Again · Different Company · PDF) │
└─────────────────────────────────────────────────────────────────┘
This is the beginning of the README. Read the rest at the original. Read the full README ↗
