Interview Practice AI is a Python desktop application that conducts mock job interviews using AI. It features a graphical user interface (GUI) built with PyQt6, allows you to upload your resume and job description, and provides real-time interview questions with voice recording capabilities. The app uses Gemini AI for generating questions and providing feedback, and Whisper for audio transcription.
Before using Interview Practice AI, ensure you have the following:
- Python: The program requires Python (3.13.5 or newer recommended). Download Python from python.org.
- Anaconda or Miniconda (recommended for managing environments).
- Git (for cloning the repository).
- A valid Gemini API Key from Google AI Studio.
- FFmpeg (required for audio processing with Whisper):
- Windows: Download from ffmpeg.org or install via
choco install ffmpeg - Mac:
brew install ffmpeg - Linux:
sudo apt install ffmpeg
- Windows: Download from ffmpeg.org or install via
To set up Interview Practice AI, follow these steps:
-
Clone the repository using git:
git clone https://github.com/anikolayev06/PrepTalk.git cd PrepTalk -
Create and activate a conda environment (recommended):
conda create -n preptalk python=3.13.5 conda activate preptalk
-
Install the required dependencies:
pip install -r requirements.txt
-
Go to Google AI Studio and create a Gemini API key.
-
Create a
.envfile in the projects/backenddirectory and add your API key:GEMINI_API_KEY_COMS25=your_api_key_here
To use Interview Practice AI:
-
Run the application:
python launch.py
-
Upload your resume (PDF format) using the "Upload Resume" button.
-
Paste or type in the job description you're applying for.
-
Click "Start Interview" to begin the mock interview session.
-
Answer each question by clicking "Start Recording" to record your voice answer.
-
Click "Stop Recording" when finished, and the AI will transcribe and provide feedback.
-
Use "Next Question" to move through the interview questions.
- AI-Powered Questions: Gemini AI generates relevant interview questions based on your resume and job description.
- Voice Recording: Record your answers using your microphone for a realistic interview experience.
- Automatic Transcription: Whisper AI transcribes your spoken answers to text.
- Instant Feedback: Receive AI-generated feedback on your responses.
- PDF Resume Parsing: Automatically extracts text from your resume PDF.
- The app uses
pdfplumberto extract text from PDF resumes. - Audio is recorded using
sounddeviceand transcribed using OpenAI's Whisper model. - Your API key is stored locally in the
.envfile and never shared. - Temporary audio recordings are stored in a system temp directory and cleaned up automatically.
- Be cautious: AI-generated feedback is based on AI interpretation and may not be 100% accurate.
- Ensure your microphone permissions are enabled for the application to record audio.
- Recording fails: Check that your microphone is properly connected and permissions are granted.
- Transcription errors: Ensure FFmpeg is installed correctly.
- API errors: Verify your Gemini API key is valid and has sufficient quota.
Original Authors:
This project is licensed under the MIT License with Attribution Requirements. See the LICENSE file for details. All forks must include proper attribution to the original authors.