You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# AI Interview Coach
This project is a sophisticated, AI-powered mock interview application built with Python and Streamlit. It provides a realistic interview experience by generating dynamic, context-aware questions based on a user's resume and a target job description.
The application leverages Google's Generative AI (Gemini) to move beyond simple keyword matching, analyzing the holistic context of a user's experience to ask insightful "why" and "how" questions, simulating a conversation with an experienced technical recruiter.
---
## Features
- **Dynamic Question Generation:** Utilizes a generative AI model to craft unique technical questions based on the specific projects and skills found in a resume.
- **Context-Aware Analysis:** Connects the user's experience directly to the requirements listed in the job description.
- **Document Parsing:** Accepts resumes in both PDF and DOCX formats.
- **Text-to-Speech:** Provides an option to have interview questions read aloud for a more immersive experience.
- **Comprehensive Performance Report:**
- Calculates a "Job Fit" score by matching resume keywords against the job description.
- Provides a detailed breakdown of which required keywords are present or missing from the resume.
- Evaluates each answer for structure and keyword relevance.
- **Secure API Key Management:** Uses Streamlit's built-in secrets management to protect the Google AI API key, ensuring it is never exposed in the code.
---
## How to Set Up and Run the Project
Follow these steps to get the application running on your local machine.
### Prerequisites
You must have Python 3.8+ installed on your system.
### 1. Project Files
Ensure you have the complete project folder containing all necessary files (`app.py`, `question_generator.py`, `requirements.txt`, etc.).
### 2. Install Dependencies
All required libraries are listed in the `requirements.txt` file. Open your terminal or command prompt, navigate to the project's root directory, and run the following command to install them:
```bash
pip install -r requirements.txt
```
### 3. Set Up Your Google AI API Key
This application requires a Google AI API key to function.
- **Get your key:** Visit [Google AI Studio](https://aistudio.google.com/) to generate your free API key.
- **Create the secrets file:**
1. In the root of your project folder, create a new folder named `.streamlit` (the name must start with a dot).
2. Inside the `.streamlit` folder, create a new file named `secrets.toml`.
- **Add your key to the file:** Open `secrets.toml` and add the following lines, pasting your secret key where indicated:
```toml
# .streamlit/secrets.toml
GOOGLE_API_KEY = "PASTE_YOUR_SECRET_API_KEY_HERE"
```
### 4. Run the Streamlit Application
Once the dependencies are installed and your API key is configured, run the following command in your terminal from the project's root directory:
```bash
streamlit run app.py
```
The application will open in a new tab in your web browser.# Resume_Interviewer.AI