File size: 2,167 Bytes
03860da
b3ac7b2
 
 
 
 
 
03860da
b3ac7b2
26d537d
03860da
 
26d537d
03860da
26d537d
03860da
26d537d
 
b3ac7b2
26d537d
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
---
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
    ```