Skip to content

varshikageu/InterviewPrepAI

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

6 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Nexora - Interview Prep AI# ๐Ÿš€ Nexora - InterviewPrepAI

Overview<div align="cente### โœ… Current Features (MVP)

  • โœ… Resume Upload (PDF & DOCX support)
  • โœ… Keyword-Based Question Selection
  • โœ… Text-Based Interview Simulation
  • โœ… Simple Feedback System
  • โœ… Clean Web Interface
  • โœ… Demo Mode with Sample Data

๐Ÿ’ก Upcoming Features (AI Roadmap)

  • ๐Ÿ”„ MongoDB Integration (In Progress)
  • ๐Ÿง  Advanced AI Resume Parsing
  • ๐Ÿ’ฌ Dynamic AI Question Generation (LLMs)
  • ๐Ÿ“Š AI-Powered Answer Analysis
  • ๐Ÿ“š Personalized Learning Recommendations
  • ๐Ÿ“ˆ User Dashboards & Progress Tracking
  • ๐ŸŒ Multi-language Supportinterview preparation system.

![Python](https:/## ๐Ÿ“ Project Structure

nexora_project/
โ”œโ”€โ”€ ๐Ÿ“‚ interview/              # Main Django app
โ”‚   โ”œโ”€โ”€ ๐Ÿ“„ views.py           # Request handlers and business logic
โ”‚   โ”œโ”€โ”€ ๐Ÿ“„ urls.py            # URL routing configuration
โ”‚   โ”œโ”€โ”€ ๐Ÿ“„ resume_parser.py   # PDF/DOCX parsing functionality
โ”‚   โ”œโ”€โ”€ ๐Ÿ“„ mongo_conn.py      # MongoDB connection handler
โ”‚   โ”œโ”€โ”€ ๐Ÿ“‚ static/            # Static assets (CSS, JS, images)
โ”‚   โ””โ”€โ”€ ๐Ÿ“‚ templates/         # HTML templates
โ”‚       โ”œโ”€โ”€ ๐Ÿ“„ upload.html    # Resume upload interface
โ”‚       โ”œโ”€โ”€ ๐Ÿ“„ questions.html # Interview questions display
โ”‚       โ””โ”€โ”€ ๐Ÿ“„ feedback.html  # Feedback and results page
โ”œโ”€โ”€ ๐Ÿ“‚ media/                 # Uploaded files storage
โ”œโ”€โ”€ ๐Ÿ“‚ nexora_project/        # Django project configuration
โ”œโ”€โ”€ ๐Ÿ“„ manage.py              # Django project management
โ”œโ”€โ”€ ๐Ÿ“„ requirements.txt       # Project dependencies
โ””โ”€โ”€ ๐Ÿ“„ README.md              # Project documentation
```adge/python-v3.8+-blue.svg)

## Features![Django](https://img.shields.io/badge/django-4.x-green.svg)

- Resume upload![License](https://img.shields.io/badge/license-MIT-blue.svg)

- Question generation![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)

- Interview simulation![Contributors](https://img.shields.io/badge/contributors-4-orange.svg)

- AI feedback

**Your Personal AI-Powered Interview Co-Pilot**

## Installation

```bash*Nexora is a smart interview preparation system designed to provide a personalized, resume-based mock interview experience. It bridges the gap between generic practice questions and real-world interviews by generating tailored questions, simulating interview sessions, and delivering structured, AI-enhanced feedback.*

pip install -r requirements.txt

python manage.py runserver[๏ฟฝ Features](#-features) โ€ข

```[๐Ÿš€ Quick Start](#-quick-start) โ€ข

[๐Ÿ“– Documentation](#-documentation) โ€ข

## Usage[๐Ÿค Contributing](#-contributing) โ€ข

1. Upload resume[๐Ÿ‘ฅ Team](#-team)

2. Answer questions

3. Get feedback</div>



## TODO---

- Implement MongoDB integration

- Add resume parsing## ๏ฟฝ๐ŸŒŸ Overview

- Integrate AI feedback system
### The Problem
Traditional interview preparation is **stressful**, **inefficient**, and **impersonal**. Candidates practice with generic questions that don't reflect their unique skills and experiences listed on their resume. This leads to:
- ๐Ÿ“‰ Lack of confidence in discussing personal background
- โšก Inefficient preparation time
- ๐ŸŽฏ Poor alignment with actual interview questions
- ๐Ÿ“ No structured feedback mechanism

### Our Solution
Nexora tackles this by creating a **dynamic and personalized preparation loop**:

1. **๐Ÿ“„ Resume Analysis** - Intelligently parses candidate's resume to understand skills, projects, and experience
2. **โ“ Tailored Question Generation** - Generates relevant questions based on parsed resume data
3. **๐ŸŽญ Interview Simulation** - Provides a clean, text-based interface to simulate real interviews
4. **๐Ÿค– AI-Powered Feedback** - Analyzes answers to provide structured feedback and improvement areas

---

## โœจ Features

<table>
<tr>
<td width="50%">

### ๏ฟฝ Current Features (MVP)
- โœ… **Resume Upload** (PDF & DOCX support)
- โœ… **Keyword-Based Question Selection**
- โœ… **Text-Based Interview Simulation**
- โœ… **Simple Feedback System**
- โœ… **Basic Report Generation**
- โœ… **Clean Web Interface**

</td>
<td width="50%">

### ๐Ÿ’ก Upcoming Features (AI Roadmap)
- ๏ฟฝ **Advanced AI Resume Parsing**
- ๏ฟฝ **Dynamic AI Question Generation (LLMs)**
- ๏ฟฝ **AI-Powered Answer Analysis**
- ๏ฟฝ **Personalized Learning Recommendations**
- ๏ฟฝ **User Dashboards & Progress Tracking**
- ๐Ÿ”ฎ **Multi-language Support**

</td>
</tr>
</table>

---

## ๐Ÿ› ๏ธ Tech Stack

<div align="center">

| Category | Technologies |
|----------|-------------|
| **Backend** | ![Python](https://img.shields.io/badge/Python-3776AB?style=flat-square&logo=python&logoColor=white) ![Django](https://img.shields.io/badge/Django-092E20?style=flat-square&logo=django&logoColor=white) |
| **Frontend** | ![HTML5](https://img.shields.io/badge/HTML5-E34F26?style=flat-square&logo=html5&logoColor=white) ![CSS3](https://img.shields.io/badge/CSS3-1572B6?style=flat-square&logo=css3&logoColor=white) ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=black) |
| **Document Processing** | ![PyPDF2](https://img.shields.io/badge/PyPDF2-FF6B6B?style=flat-square) ![python-docx](https://img.shields.io/badge/python--docx-4ECDC4?style=flat-square) |
| **AI/ML** | ![NLP](https://img.shields.io/badge/NLP-45B7D1?style=flat-square) ![OpenAI](https://img.shields.io/badge/OpenAI-412991?style=flat-square&logo=openai&logoColor=white) |

</div>

---

## ๐Ÿš€ Quick Start

### Prerequisites
- ![Python](https://img.shields.io/badge/Python-3.8+-blue?style=flat-square&logo=python) or higher
- ![pip](https://img.shields.io/badge/pip-package%20manager-blue?style=flat-square)
- ![Git](https://img.shields.io/badge/Git-version%20control-orange?style=flat-square&logo=git)

### โšก Installation

1. **Clone the repository**
   ```bash
   git clone https://github.com/pwnjoshi/InterviewPrepAI.git
   cd InterviewPrepAI
  1. Create and activate virtual environment

    # Windows
    python -m venv venv
    .\venv\Scripts\activate
    
    # macOS/Linux
    python3 -m venv venv
    source venv/bin/activate
  2. Install dependencies

    pip install -r requirements.txt
  3. Run database migrations

    python manage.py migrate
  4. Start the development server

    python manage.py runserver
  5. Open your browser and navigate to http://127.0.0.1:8000/

๐ŸŽ‰ You're all set! Start uploading your resume and practicing interviews.


๐Ÿ“ Project Structure

nexora_project/
โ”œโ”€โ”€ ๐Ÿ“‚ interview/              # Main Django app
โ”‚   โ”œโ”€โ”€ ๐Ÿ“„ views.py           # Request handlers and business logic
โ”‚   โ”œโ”€โ”€ ๐Ÿ“„ urls.py            # URL routing configuration
โ”‚   โ”œโ”€โ”€ ๐Ÿ“„ resume_parser.py   # PDF/DOCX parsing functionality
โ”‚   โ””โ”€โ”€ ๐Ÿ“‚ templates/         # HTML templates
โ”‚       โ”œโ”€โ”€ ๐Ÿ“„ upload.html    # Resume upload interface
โ”‚       โ”œโ”€โ”€ ๐Ÿ“„ questions.html # Interview questions display
โ”‚       โ””โ”€โ”€ ๐Ÿ“„ feedback.html  # Feedback and results page
โ”œโ”€โ”€ ๐Ÿ“‚ data/                  # Data storage
โ”‚   โ””โ”€โ”€ ๐Ÿ“„ question_bank.json # Question database and mappings
โ”œโ”€โ”€ ๐Ÿ“„ manage.py              # Django project management
โ””โ”€โ”€ ๏ฟฝ README.md              # Project documentation

๐Ÿ—บ๏ธ Roadmap

๐ŸŽฏ Phase 1: MVP Development (Current)

  • Setup Django project structure
  • Implement resume parser for PDF/DOCX
  • Create static question bank and selection logic
  • Build web interface for interview simulation
  • Develop basic feedback module
  • MongoDB Integration (In Progress)

๐Ÿš€ Phase 2: Full-Featured AI System

  • Integrate advanced NLP for resume parsing
  • Implement LLM for dynamic question generation
  • Develop AI-powered semantic answer analysis
  • Add user accounts and progress tracking
  • Enhance UI/UX with modern design
  • Deploy to cloud platform (AWS/Heroku)

๐ŸŒŸ Phase 3: Advanced Features

  • Multi-language interview support
  • Video interview simulation
  • Industry-specific question banks
  • Integration with job portals
  • Mobile application development

๐ŸŽฌ Demo

๐Ÿ“น Live Demo Coming Soon!

We're currently preparing an interactive demo showcasing the complete interview workflow. Stay tuned!


๐Ÿ“– Documentation

๐Ÿ”ง API Reference

  • Resume Upload: /upload/ - Handles PDF/DOCX file uploads
  • Question Generation: /questions/ - Displays tailored interview questions
  • Feedback System: /feedback/ - Provides detailed analysis and suggestions

๐ŸŽฏ Usage Examples

# Example: Resume parsing
from interview.resume_parser import ResumeParser

parser = ResumeParser()
skills = parser.extract_skills("path/to/resume.pdf")
print(f"Detected skills: {skills}")

๐Ÿค Contributing

We welcome contributions from the community! Here's how you can help:

๐Ÿ› Reporting Bugs

  1. Check existing issues to avoid duplicates
  2. Create a detailed bug report with reproduction steps
  3. Include system information and error logs

๐Ÿ’ก Suggesting Features

  1. Open an issue with the "enhancement" label
  2. Provide a clear description of the proposed feature
  3. Explain the use case and expected behavior

๐Ÿ”ง Contributing Code

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

๐Ÿ‘ฅ Team

Team NEXORA (PY-III-T031)

Varshika Saini
Varshika Saini
Team Lead & Frontend Developer
๐Ÿ“ง varshikasaini17@gmail.com
Pawan Joshi
Pawan Joshi
Backend & Parser Developer
๐Ÿ“ง joshipawan2021@gmail.com
Aaditya Uniyal
Aaditya Uniyal
Question Bank & Logic
๐Ÿ“ง aaditya.uniyal22@gmail.com
Nehal Vaid
Nehal Vaid
Feedback & Reporting Module
๐Ÿ“ง vaidnehal10@gmail.com

๐Ÿ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.


๐Ÿ™ Acknowledgments

  • Thanks to all contributors who helped shape this project
  • Inspired by the need for better interview preparation tools
  • Built with โค๏ธ for the developer community

๐ŸŒŸ Star this repository if you found it helpful!

GitHub stars GitHub forks GitHub watchers

โฌ† Back to Top

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 55.3%
  • HTML 43.3%
  • CSS 1.4%