🧠 AI Interview
Welcome to the AI Interview project — a modern, AI-powered interview agent that conducts mock interviews and evaluates candidate responses in real-time. Built with FastAPI, WebSockets, and Silero VAD, it enables interactive voice-based communication powered by machine learning. 🚀 Features
🎙️ Real-time Interview via WebSocket
🔊 Voice Activity Detection using Silero VAD
🤖 Dynamic Question Handling via LangChain
📡 FastAPI WebSocket API
⚙️ Dockerized & Ready for Cloud Deployment (e.g. Render)
📦 Prerequisites
Before you start, make sure you have the following installed:
Python 3.9+
Docker (optional, for deployment)
FFmpeg (for audio processing)
⚙️ Installation
Clone the repo:
git clone https://github.com/your-username/ai-interview.git cd ai-interview
Install dependencies:
pip install -r requirements.txt
Ensure system packages for audio are installed (Linux):
sudo apt update sudo apt install ffmpeg libsndfile1
Make the script executable:
chmod +x run ./run
On Windows
Create a run.bat file with the following contents:
@echo off uvicorn main:app --host 0.0.0.0 --port 8000
Then double-click it to start the server. 🐳 Running with Docker
Build the Docker image:
docker build -t ai-interview .
Run the container:
docker run -p 8000:8000 ai-interview
🧪 Testing
Once running, test your FastAPI app locally:
Use any WebSocket client (e.g. Postman or browser frontend) to test endpoints. 🤝 Contributing
Contributions are welcome! Feel free to open issues or submit pull requests to improve this project. 📄 License
This project is licensed under the MIT License. See LICENSE for more information.