Interview Assistant

An AI assistant for technical interviews with React/Next.js frontend.

Project Structure

The project is organized into two main parts:

1. Backend API (Python/FastAPI): Handles application logic and connections with the OpenAI API
2. Frontend (React/Next.js): Modern and responsive user interface

Prerequisites

• Python 3.8+
• Poetry for Python dependency management
• Node.js 18+
• npm or yarn
• An OpenAI account with a valid API key

Configuration

Backend (Python)

1. Clone the repository
2. Install dependencies with Poetry:

   poetry install

3. Create a .env file in the main directory with the following content:

   OPENAI_API_KEY=your_openai_api_key_here
   

Frontend (Next.js)

1. Navigate to the frontend directory:

   cd frontend

2. Install dependencies:

   npm install
   # or
   yarn install

3. Create a .env.local file with the following content:

   NEXT_PUBLIC_API_URL=http://localhost:8000
   

Starting the Application

Starting the Backend API

# From the main project directory
poetry run start-api
# or
poetry run python -m intervista_assistant.api_launcher

The API server will be available at http://localhost:8000.

Starting the Next.js Frontend

# From the frontend directory
npm run dev
# or
yarn dev

The frontend application will be available at http://localhost:3000.

Features

• Text message sending
• Audio recording and transcription
• Screenshot analysis
• Support for advanced analysis ("Think")
• Modern and responsive user interface

Description

Interview Assistant is a desktop application that helps software developers during technical job interviews. The application records the interview audio, transcribes it using GPT-4o Audio, detects technical questions, and generates detailed answers using GPT-4o.

The answers are displayed both in the main interface and in easily accessible popups during the interview.

Main Features

• Real-Time Audio Transcription: Records and transcribes audio during interviews.
• Automatic Question Detection: Automatically detects when a question is asked.
• Detailed Technical Answers: Generates technical answers using GPT-4o.
• Answer Popups: Displays answers in popups for easy consultation during the interview.
• Screenshot Functionality: Allows capturing, saving, and sharing screenshots of the interview.
• Conversation Saving: Saves the entire conversation in JSON format.

Requirements

• Python 3.8 or higher
• OpenAI API key (to use GPT-4o)
• Dependencies listed in requirements.txt

Installation

1. Clone the repository or download the files:

   git clone https://github.com/your-username/intervista-assistant.git
   cd intervista-assistant
   

2. Install the dependencies:

   pip install -r intervista_assistant/requirements.txt
   

3. Create a .env file in the intervista_assistant directory based on the .env.example file:

   cp intervista_assistant/.env.example intervista_assistant/.env
   

4. Edit the .env file by inserting your OpenAI API key:

   OPENAI_API_KEY=your-openai-api-key-here
   

Usage

You can start the application in one of the following ways:

1. Running the main script:

   python run.py
   

2. Running the launcher from within the intervista_assistant directory:

   cd intervista_assistant
   python launcher.py
   

User Guide

1. Press the "Start Recording" button to begin recording audio.
2. Speak clearly, asking technical questions related to software development.
3. The application will automatically detect questions and generate answers.
4. Answers will appear in the "Answer" area and in a popup.
5. Use the "Screenshot" button to capture the screen during the interview.
6. The "Share Screenshot" button allows saving and copying the image path.
7. At the end of the interview, use "Save Conversation" to save the conversation in JSON.

Project Structure