Interview-AI-Bot / README.md
Mervecaliskan's picture
Update README.md
26d537d verified
|
Raw History Blame Contribute Delete
2.17 kB
---
title: AI Interview Coach
emoji: ๐ŸŽ™๏ธ
colorFrom: blue
colorTo: indigo
sdk: streamlit
app_file: app.py
pinned: false
license: mit
short_description: "Real-time voice interview simulation powered by Llama-3"
---
# ๐ŸŽ™๏ธ AI Interview Coach: Real-Time Voice Simulator
This project is an **Autonomous Interview Agent** designed to conduct realistic, voice-based technical interviews. It processes a candidate's Resume (PDF), generates context-aware technical questions, and interacts via voice with ultra-low latency.
**Built by:** Merve ร‡alฤฑลŸkan
**Purpose:** To demonstrate an end-to-end Generative AI pipeline featuring RAG, Audio Processing, and LLM orchestration.
---
## ๐Ÿš€ Key Features
* **๐Ÿ“„ RAG-Based Context:** Analyzes uploaded PDF resumes to generate tailored, domain-specific interview questions.
* **โšก Ultra-Fast Inference:** Powered by **Groq API** running **Llama-3-8b**.
* **๐Ÿ—ฃ๏ธ Speech-to-Text (STT):** Utilizes **Whisper-large-v3** (via Groq) for highly accurate transcription.
* **๐Ÿ”Š Text-to-Speech (TTS):** Converts the AI's feedback and follow-up questions into audio.
* **๐Ÿง  Chain-of-Thought Evaluation:** The AI listens, evaluates logic, and provides feedback.
---
## ๐Ÿ› ๏ธ Tech Stack
* **LLM Engine:** [Groq Cloud](https://groq.com/) (Llama-3-8b-8192)
* **Speech Processing:** Whisper-large-v3 (STT) & gTTS (TTS).
* **Framework:** [Streamlit](https://streamlit.io/)
* **Orchestration:** LangChain
* **Vector/Data Handling:** PyPDFLoader
---
## โš™๏ธ How It Works
1. **Upload Resume:** The user uploads a PDF resume via the sidebar.
2. **Context Extraction:** The app extracts text from the PDF.
3. **Voice Interaction:** User speaks, AI transcribes, thinks, and responds with voice.
---
## ๐Ÿ“ฆ Local Installation
To run this project locally:
1. **Clone the repo:**
```bash
git clone <repo-url>
```
2. **Install dependencies:**
```bash
pip install -r requirements.txt
```
3. **Set up API Keys:**
Create a `.streamlit/secrets.toml` file:
```toml
GROQ_API_KEY = "your-groq-api-key-here"
```
4. **Run the app:**
```bash
streamlit run app.py
```