File size: 2,045 Bytes
226b286
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
---

title: Interviewer Assistant
emoji: πŸ‘”
colorFrom: green
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
license: mit
short_description: Agentic AI for Resume Analysis & Interview Prep
---


# πŸ‘” Interviewer Assistant

A **Multi-Agent System** designed to assist HR and technical interviewers by automatically analyzing job descriptions and resumes to generate tailored interview questions and fitness scores.

## πŸš€ Features

- **🧠 Multi-Agent Swarm**:
  - **Job Analyst**: Extracts key requirements from JDs.
  - **Candidate Profiler**: Analyzes resumes for strengths and gaps.
  - **Evaluator**: Scores candidates on Technical, Behavioral, and Leadership metrics.
  - **Interview Designer**: Generates bespoke interview questions.
- **πŸ“„ Input Flexibility**: Accepts raw text for JD and Resume/LinkedIn profile.
- **πŸ“Š Structured Evaluation**: Provides a clear score and justification.

## πŸ› οΈ Architecture

```

src/interview-assistant/

β”œβ”€β”€ app.py                  # Streamlit UI (Orchestrator)

β”œβ”€β”€ teams/                  # Team Definitions

β”‚   └── team.py             # GroupChat Configuration

β”œβ”€β”€ aagents/                # Agent Definitions

β”‚   β”œβ”€β”€ job_analyst.py      

β”‚   β”œβ”€β”€ candidate_profiler.py

β”‚   β”œβ”€β”€ evaluator.py

β”‚   β”œβ”€β”€ interview_designer.py 

β”‚   └── admin.py            

└── Dockerfile              # Deployment Configuration

```

## πŸ“¦ Startup

### Local Run

1. **Install Dependencies**:
   ```bash

   pip install -r src/interviewer-assistant/requirements.txt

   ```

2. **Run Application**:
   ```bash

   streamlit run src/interviewer-assistant/app.py

   ```
   The app will open at `http://localhost:8501`.

## 🐳 Docker / Deployment

The project is packaged for **Hugging Face Spaces** (Docker SDK).

```bash

# Build

docker build -t interviewer-assistant -f src/interviewer-assistant/Dockerfile .



# Run

docker run -p 7860:7860 interviewer-assistant

```