yazid4170/QuirkHire

QuirkHire is an AI-powered recruitment platform that matches candidates with job opportunities using semantic understanding of skills, experiences, and cultural fit. Developed by a team of computer science students from ESPRIT Monastir in Tunisia, this platform uses state-of-the-art NLP and LLM technologies to go beyond simple keyword matching. # QuirkHire: AI-Powered Career Recommendation Platform ## 🚀 Overview QuirkHire is an advanced AI-powered recruitment platform that matches candidates with job opportunities using semantic understanding of skills, experiences, and cultural fit. Developed by a team of computer science students from ESPRIT Monastir in Tunisia, this platform uses state-of-the-art NLP and LLM technologies to go beyond simple keyword matching. ## ✨ Key Features - **Smart Candidate Matching**: Uses `sentence-transformers` and advanced NLP to analyze and match job descriptions with candidate profiles - **Interview Preparation Assistant**: AI-powered tool to help candidates prepare for interviews - **Recruiter Dashboard**: Powerful interface for managing candidates and job postings - **Modern UI/UX**: Beautiful, responsive interface with animated components built with Material UI and Framer Motion - **Secure Authentication**: Complete user management system with role-based access - **Multi-Role Support**: Specialized experiences for candidates, recruiters, and administrators ## 🧠 Technology Stack - **Frontend**: React.js, Material UI, Framer Motion - **Backend**: Django, Python - **NLP**: Sentence Transformers, spaCy, Natural Language Processing - **Database**: PostgreSQL with Supabase - **Authentication**: JWT with Supabase Auth ## 🛠️ Installation ### Prerequisites - Node.js (v14 or later) - Python (v3.8 or later) - PostgreSQL ### Backend Setup 1. **Clone the repository** ```bash git clone github.com cd CareerReco ``` 2. **Set up a virtual environment** ```bash python -m venv venv # On Windows venv\Scripts\activate # On macOS/Linux source venv/bin/activate ``` 3. **Install backend dependencies** ```bash pip install -r requirements.txt ``` 4. **Set up the database** ```bash python manage.py makemigrations recommender python manage.py migrate ``` 5. **Run the backend server** ```bash python manage.py runserver ``` ### Frontend Setup 1. **Navigate t …