HireGenie AI Career Prep Platform with Django & React

Installation Steps

1. Download and extract the project ZIP file.
2. Open the project folder in VS Code.
3. Set up the backend:

cd backend
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

1. Create a .env file inside the backend folder and add required environment variables:

SECRET_KEY=your_django_secret_key
DEBUG=True
DATABASE_URL=your_database_url
AI_API_KEY=your_ai_api_key

1. Run database migrations:

python manage.py makemigrations
python manage.py migrate

1. Create an admin user:

python manage.py createsuperuser

1. Start the Django backend server:

python manage.py runserver

Backend will run at:

http://127.0.0.1:8000/

1. Open a new terminal and set up the frontend:

cd frontend
npm install
npm run dev

Frontend will run at:

http://localhost:5173/

1. Open the frontend URL in your browser and start using the project.

Usage Guide

HireGenie AI is designed to help students, freshers, and job seekers prepare for internships and entry-level jobs.

After installation, users can register and log in to access the career preparation dashboard. From the dashboard, users can manage their profile, upload or build resumes, analyze resumes for ATS improvement, practice mock interview questions, solve coding tasks, attempt aptitude tests, view job recommendations, and track their preparation progress.

Main usage flow:

1. Register a new user account.
2. Log in using email and password.
3. Access the protected student dashboard.
4. Upload or create a resume.
5. Use the ATS resume analyzer to get improvement suggestions.
6. Practice HR and technical interview questions.
7. Solve coding practice questions.
8. Take aptitude preparation tests.
9. View job recommendations and save relevant jobs.
10. Track progress through dashboard analytics.

Admin users can manage users, resumes, job-related data, practice modules, and platform content from the Django admin panel.

Expected output:

• Secure login and registration
• User dashboard
• Resume analysis feedback
• Interview practice questions
• Coding and aptitude preparation modules
• Job-readiness tracking
• Clean full-stack project structure

System Requirements

Software Requirements:

• Operating System: Windows, macOS, or Linux
• Python: 3.10 or above
• Node.js: 18 or above
• npm: 9 or above
• Database: PostgreSQL recommended, SQLite can be used for local testing
• Code Editor: VS Code recommended
• Browser: Chrome, Edge, or Firefox
• Git: Latest version recommended

Backend Requirements:

• Django
• Django REST Framework
• JWT Authentication
• Python virtual environment
• Required Python packages from requirements.txt

Frontend Requirements:

• React.js
• Vite
• Tailwind CSS
• Axios
• React Router

Hardware Requirements:

• RAM: Minimum 4 GB, recommended 8 GB
• Storage: Minimum 1 GB free space
• Processor: Dual-core or higher
• Internet connection for package installation and AI API usage

Known Issues

• AI-based features require a valid API key.
• Live resume analysis quality depends on the input resume content.
• PostgreSQL setup may require updating database credentials in the environment file.
• Some features may need internet access when using external APIs.
• For production deployment, DEBUG should be set to False and secure environment variables should be configured.

Future Enhancements

• Add Google OAuth login
• Add payment/subscription plans
• Add advanced AI mock interview scoring
• Add resume PDF builder with multiple templates
• Add recruiter dashboard
• Add real-time chat support
• Add email notifications
• Add advanced analytics for student progress
• Add college placement cell admin module
• Deploy backend and frontend with production-ready CI/CD pipeline