Skip to content

Repository files navigation

Mockview

AI-powered voice interview simulator that conducts realistic job interviews using your resume, target role, and experience.

Features

  • 🎙️ Voice-based AI interviewer
  • 📄 Resume-based questions
  • 🎯 Role-specific technical and practical questions
  • 🧠 Adaptive follow-up questions
  • 🔊 AI voice with Groq TTS
  • 📝 Groq Whisper speech-to-text
  • 📊 Brutally honest interview evaluation
  • 🔐 No database or hosting required

Tech Stack

  • React + Vite
  • OpenRouter — AI interviewer and evaluation
  • Groq Whisper — speech-to-text
  • Groq Orpheus — text-to-speech

Setup

git clone https://github.com/YOUR_USERNAME/Mockview.git
cd Mockview
npm install

Create a .env file:

VITE_OPENROUTER_API_KEY=your_openrouter_key
VITE_GROQ_API_KEY=your_groq_key

Run:

npm run dev

Groq Voice Setup

Mockview uses Groq for speech-to-text and text-to-speech.

  1. Create a Groq API key.
  2. For Orpheus TTS, open the Groq Playground and select canopylabs/orpheus-v1-english.
  3. If Groq shows a Terms / Accept Terms prompt, accept the model terms before using TTS.
  4. Whisper STT uses whisper-large-v3-turbo.
  5. Groq free-tier rate limits apply. If the TTS limit is reached, wait for the limit to reset.

OpenRouter

OpenRouter powers the AI interviewer and final evaluation.

Keep API keys in .env and never commit .env to GitHub.

Interview Flow

Candidate details + Resume
          ↓
     Maya greets you
          ↓
      10 questions
          ↓
 Resume + Role + Skills
          ↓
 Voice answer → Whisper
          ↓
 AI interviewer → Next question
          ↓
 Orpheus → Maya speaks
          ↓
      Final evaluation

Note

Mockview is currently a local GitHub project/demo. No database or hosting is required.

About

AI-powered voice interview simulator that conducts realistic job interviews using your resume, target role, and experience.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages