Mock Behavioral Interview Platform

A modern web application for practicing behavioral interviews with AI-powered feedback using Google's Gemini LLM.

Features

• Random Behavioral Questions: Get a new behavioral interview question each time
• 10-Minute Timer: Practice with realistic time constraints
• Speech-to-Text: Use voice recording for natural responses
• Manual Input: Type your answers if you prefer
• AI Feedback: Get detailed feedback on your responses using Gemini AI
• Modern UI: Beautiful, responsive design with smooth animations

Setup

Prerequisites

• Node.js (version 16 or higher)
• npm or yarn
• Google Gemini API key

Installation

1. Clone the repository:

git clone <repository-url>
cd mock-behavioral-interview

2. Install dependencies:

npm install

3. Set up your Gemini API key:
   • Get your API key from Google AI Studio
   • Create a .env file in the root directory:

VITE_GEMINI_API_KEY=your_actual_api_key_here

4. Start the development server:

npm run dev

5. Open your browser and navigate to http://localhost:3000

Usage

1. Start an Interview: Click "Start New Interview" to begin
2. Read the Question: Review the behavioral question displayed
3. Record Your Answer:
   • Click the microphone button to start voice recording
   • Or type your answer manually in the text area
4. Submit: Click "Submit Interview" when you're done
5. Review Feedback: Get detailed AI feedback on your performance

Features in Detail

Timer

• 10-minute countdown timer
• Color-coded warnings (green → orange → red)
• Automatic stop when time runs out

Speech Recognition

• Real-time speech-to-text conversion
• Continuous recording with interim results
• Works in modern browsers (Chrome, Edge, Safari)
• Handles "no-speech" errors gracefully
• Visual indicator for when the microphone is active

AI Feedback

The system evaluates your response across multiple dimensions:

• Communication (1-5): Clarity, structure, articulation
• Problem Solving (1-5): Analytical thinking, approach
• Collaboration (1-5): Teamwork, interpersonal skills
• Leadership (1-5): Initiative, decision-making
• Technical Skills (1-5): Relevant knowledge and expertise

Question Bank

Includes 20 common behavioral interview questions covering:

• Project failures and learning
• Team collaboration challenges
• Decision-making under uncertainty
• Adaptability and change management
• Leadership and initiative
• Conflict resolution
• Innovation and creativity

Technical Stack

• Frontend: React 18 with Vite
• Styling: CSS3 with modern design patterns
• AI: Google Gemini 1.5 Flash API
• Speech Recognition: Web Speech API
• Build Tool: Vite

Environment Variables

Create a .env file in the root directory:

VITE_GEMINI_API_KEY=your_gemini_api_key_here

Browser Compatibility

• Chrome 66+
• Firefox 60+
• Safari 14+
• Edge 79+

Note: Speech recognition works best in Chrome and Edge.

Troubleshooting

Speech Recognition Not Working

• Ensure you're using a supported browser
• Check microphone permissions
• Try refreshing the page

API Key Issues

• Verify your Gemini API key is correct
• Check that the .env file is in the root directory
• Ensure the environment variable starts with VITE_

Build Issues

• Clear node_modules and reinstall: rm -rf node_modules && npm install
• Check Node.js version: node --version

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

License

MIT License - see LICENSE file for details.

Support

For issues and questions, please open an issue on GitHub.