Skip to content

maitamdev/interview-practice

Repository files navigation

🎯 AI Interview Coach

AI Interview Coach React TypeScript Supabase Groq

Luyện tập phỏng vấn với AI thông minh - Nhận feedback chi tiết và cải thiện kỹ năng mỗi ngày

Demo · Report Bug


✨ Features

Feature Description
🎯 Multi-Role Support Frontend, Backend, Fullstack, QA, BA, DevOps, Mobile, Data Engineer
📊 Adaptive Difficulty Intern → Junior → Mid → Senior với câu hỏi phù hợp
🔄 Interview Modes Behavioral, Technical, Mixed
🌐 Bilingual Hỗ trợ tiếng Việt và tiếng Anh
🎙️ Voice TTS VieNeu TTS giọng Việt tự nhiên + Web Speech fallback
🎤 Voice Input Nhận diện giọng nói realtime
📈 Detailed Feedback Chấm điểm theo rubric + gợi ý cải thiện
🎮 Gamification XP, Badges, Streaks, Daily Challenges
🤖 AI Coach Recommendations cá nhân hóa

🛠️ Tech Stack

Frontend:  React 18 + TypeScript + Vite + Tailwind CSS + shadcn/ui
Backend:   Supabase (PostgreSQL + Auth + Edge Functions)
AI:        Groq API (LLaMA 3.3 70B Versatile)
TTS:       VieNeu (Vietnamese) + Web Speech API (fallback)
Deploy:    Vercel (Frontend) + Supabase (Backend) + HF Spaces (TTS)

🚀 Quick Start

Prerequisites

  • Node.js 18+
  • npm/yarn/bun
  • Supabase account
  • Groq API key

1. Clone & Install

git clone https://github.com/maitamdev/interview-practice.git
cd interview-practice
npm install

2. Environment Setup

cp .env.example .env

Edit .env:

VITE_SUPABASE_PROJECT_ID="your-project-id"
VITE_SUPABASE_PUBLISHABLE_KEY="your-anon-key"
VITE_SUPABASE_URL="https://your-project.supabase.co"
VITE_TTS_SERVER_URL="https://your-tts.hf.space"

3. Run Development Server

npm run dev

Open http://localhost:8080

📦 Project Structure

├── src/
│   ├── components/     # UI Components
│   │   ├── ui/         # shadcn/ui components
│   │   ├── interview/  # Interview-specific components
│   │   └── dashboard/  # Dashboard components
│   ├── hooks/          # Custom React hooks
│   ├── pages/          # Page components
│   ├── types/          # TypeScript types
│   └── integrations/   # Supabase client
├── supabase/
│   ├── functions/      # Edge Functions (AI logic)
│   └── migrations/     # Database migrations
└── tts-server/         # VieNeu TTS server (Docker)

🌐 Deployment

See DEPLOY.md for detailed instructions.

Service Platform Status
Frontend Vercel Vercel
Backend Supabase Supabase
TTS HF Spaces HF

📝 License

MIT © 2025 DevTam


Made with ❤️ for Vietnamese developers

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages