charantejapolavarapu commited on
Commit
75d42b4
ยท
verified ยท
1 Parent(s): 634ea61

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +31 -83
README.md CHANGED
@@ -1,93 +1,41 @@
1
  ---
2
- title: Smart Interview Simulator
3
- emoji: ๐ŸŽค
4
  colorFrom: blue
5
- colorTo: purple
6
  sdk: gradio
7
- sdk_version: 6.5.1
8
- python_version: '3.10'
9
  app_file: app.py
10
  pinned: false
 
 
11
  ---
12
 
13
- # ๐ŸŽค Smart Interview Simulator (AI Voice Bot)
14
 
15
- An AI-powered voice-based mock interview platform built using Speech Recognition and Large Language Models.
16
-
17
- This project allows users to simulate a technical interview by answering questions using voice input and receiving structured AI-generated evaluation and feedback.
18
-
19
- ---
20
 
21
  ## ๐Ÿš€ Features
22
-
23
- - ๐ŸŽ™ Voice-based answer submission
24
- - ๐Ÿง  Speech-to-Text using Whisper
25
- - ๐Ÿค– AI answer evaluation using Mistral-7B-Instruct via Hugging Face Inference API
26
- - ๐Ÿ“Š Structured scoring:
27
- - Technical Accuracy
28
- - Clarity
29
- - Depth
30
- - Overall Score
31
- - ๐ŸŽฏ Difficulty levels (Easy / Medium / Hard)
32
-
33
- ---
34
-
35
- ## ๐Ÿ—๏ธ System Architecture
36
-
37
- User Voice Input
38
- โ†“
39
- Speech Recognition (Whisper)
40
- โ†“
41
- Answer Transcription
42
- โ†“
43
- Prompt Engineering
44
- โ†“
45
- LLM Evaluation
46
- โ†“
47
- Structured Feedback & Score
48
-
49
- ---
50
-
51
- ## ๐Ÿ› ๏ธ Tech Stack
52
-
53
- - Python
54
- - Gradio
55
- - Transformers
56
- - Hugging Face Inference API
57
- - Whisper (Speech Recognition Model)
58
- - Mistral-7B-Instruct (Large Language Model)
59
-
60
- ---
61
-
62
- ## ๐Ÿ“Š Evaluation Criteria
63
-
64
- The AI evaluates answers based on:
65
-
66
- - Technical Accuracy (0โ€“10)
67
- - Clarity (0โ€“10)
68
- - Depth (0โ€“10)
69
- - Overall Score (0โ€“10)
70
- - Improvement Suggestions
71
-
72
- ---
73
-
74
- ## ๐Ÿ”ฎ Future Improvements
75
-
76
- - ๐Ÿ“ˆ Performance analytics dashboard
77
- - ๐Ÿ’พ Interview history tracking
78
- - ๐Ÿ“„ PDF performance reports
79
- - ๐ŸŽ™ Emotion detection from voice
80
- - ๐Ÿ”„ Follow-up question generation
81
- - ๐Ÿง‘โ€๐Ÿ’ป Coding interview simulation
82
-
83
- ---
84
-
85
- ## ๐Ÿ† Resume Description
86
-
87
- Developed a Voice-Based AI Interview Simulator using Whisper for speech recognition and Mistral-7B via Hugging Face Inference API for intelligent technical answer evaluation and structured scoring.
88
-
89
- ---
90
-
91
- ## ๐Ÿ“œ License
92
-
93
- This project is intended for educational and research purposes.
 
1
  ---
2
+ title: AI Interview Simulator
3
+ emoji: ๐Ÿค–
4
  colorFrom: blue
5
+ colorTo: indigo
6
  sdk: gradio
7
+ sdk_version: 5.0.0
 
8
  app_file: app.py
9
  pinned: false
10
+ license: mit
11
+ short_description: Practice technical interviews with AI-generated feedback.
12
  ---
13
 
14
+ # ๐Ÿค– Smart Interview Simulator
15
 
16
+ An AI-powered interview practice tool that generates role-specific technical questions and provides constructive feedback and scoring.
 
 
 
 
17
 
18
  ## ๐Ÿš€ Features
19
+ - **Role-Based Questions:** Enter any job title (e.g., "Data Scientist", "Frontend Engineer") to get relevant questions.
20
+ - **Difficulty Settings:** Choose between Easy, Medium, and Hard levels.
21
+ - **Resume Integration:** Paste your skills to receive personalized questions based on your experience.
22
+ - **AI Feedback:** Get a detailed evaluation of your answer and a score out of 10.
23
+ - **Fast Performance:** Uses Hugging Face's new Inference Router for quick responses.
24
+
25
+ ## ๐Ÿ› ๏ธ Setup & Requirements
26
+
27
+ ### 1. Secrets Configuration
28
+ This Space requires a Hugging Face User Access Token to communicate with the AI model.
29
+ 1. Go to your **Space Settings**.
30
+ 2. Scroll to **Variables and Secrets**.
31
+ 3. Create a **New Secret**:
32
+ - **Key:** `HF_TOKEN`
33
+ - **Value:** [Your Hugging Face Token]
34
+
35
+ ### 2. Local Installation (Optional)
36
+ If you want to run this locally:
37
+ ```bash
38
+ git clone [https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME](https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME)
39
+ cd YOUR_SPACE_NAME
40
+ pip install -r requirements.txt
41
+ python app.py