Skip to content

An intelligent interview platform that conducts automated job interviews using AI. The system analyzes candidate resumes, asks relevant questions, and provides detailed feedback and scoring.

Notifications You must be signed in to change notification settings

manthan89-py/AI-Interview-System

Repository files navigation

🤖 AI Interview System

An intelligent interview platform that conducts automated job interviews using AI. The system analyzes candidate resumes, asks relevant questions, and provides detailed feedback and scoring.

✨ Features

  • Resume Analysis: Upload your PDF resume and get key highlights extracted automatically
  • Personalized Questions: AI generates interview questions based on your resume and the job description
  • Voice Interaction: Speak your answers naturally - the system will transcribe and analyze them
  • Real-time Chat: Chat interface showing the conversation flow
  • Intelligent Scoring: Get detailed feedback and scores for each answer
  • Complete Evaluation: Receive an overall interview score and comprehensive report

🚀 How It Works

1. Setup

  • Upload your resume (PDF format)
  • Paste the job description you're applying for
  • Select Maximum number of Questions (Optional)
  • Select AI Interviewer Voice (Optional)
  • Click "Submit" to process your information

2. Interview Process

  • Click "Start Interview" to begin
  • The AI will greet you and ask the first question
  • Listen to each question (text-to-speech enabled)
  • Record your answer using the audio recorder (Make sure to use Chrome Browser Only)
  • The system transcribes and analyzes your response
  • Receive the next question based on your previous answers

3. Get Results

  • Complete selected number interview questions
  • Receive detailed feedback for each answer
  • Get an overall interview score out of 10
  • Review the complete chat history and evaluation report

🎯 What Makes It Special

  • Adaptive Questioning: Each question builds on your previous answers
  • Natural Conversation: Feels like talking to a real interviewer
  • Detailed Feedback: Understand what you did well and areas for improvement
  • Professional Interface: Clean, easy-to-use chat-based design
  • Complete Documentation: Full interview transcript and scoring breakdown

📋 Requirements

  • Internet connection for AI processing
  • Microphone access for recording answers
  • PDF resume file
  • Job description text
  • LLM API key for AI processing
    • Supported Models (LiteLLM): https://docs.litellm.ai/docs/providers (Change LLM_MODEL in .env)
    • Free Experimental Model from MistralAI: https://mistral.ai/
    • Note: If you're using a different model provider such as OpenAI, be sure to update the environment variable from MISTRAL_API_KEY to OPENAI_API_KEY as per the LiteLLM guidelines.
  • Speechmatics API key for speech-to-text

🎨 Interface

The system features a modern chat interface similar to ChatGPT:

  • AI Interviewer messages appear on the left (questions and instructions)
  • Your responses appear on the right (transcribed from audio)
  • Progress tracker shows which question you're on
  • Audio recorder for easy voice input

📊 Scoring System

Each answer receives:

  • Individual score (0-10)
  • Detailed written feedback
  • Suggestions for improvement

Final results include:

  • Overall interview score
  • Question-by-question breakdown
  • Complete conversation history
  • Personalized recommendations

🚀 How to run in local environment.

  1. Clone the repository
  2. Create a virtual environment
  3. Install dependencies inside the virtual environment.
  4. Add environment variables (.env.example) like API keys
  5. Run the application.

🔄 Multiple Interviews

  • Take multiple practice interviews
  • Try different job descriptions
  • Track your improvement over time
  • Perfect your interview skills

💡 Tips for Best Results

  • Speak clearly when recording answers
  • Provide detailed, specific responses
  • Take your time - there's no rush
  • Treat it like a real interview
  • Review feedback to improve

Ready to ace your next interview? Upload your resume and get started!

About

An intelligent interview platform that conducts automated job interviews using AI. The system analyzes candidate resumes, asks relevant questions, and provides detailed feedback and scoring.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published