Quick Start Guide

1 Clone the Repository

git clone https://github.com/ElaMCB/ElaMCB.github.io.git
cd ElaMCB.github.io/job-search-automation/backend

2 Install Dependencies

pip install -r requirements.txt

This installs FastAPI, scikit-learn, pandas, and resume parsers.

3 Get FREE Adzuna API Key (2 minutes)

Sign up for instant free access:

After signup, create backend/.env file:

ADZUNA_APP_ID=your_app_id_here
ADZUNA_APP_KEY=your_app_key_here

4 Start the API Server

python main.py

🚀 Starting Job Search Automation API...
📍 API will be available at: http://localhost:8000
📚 Documentation: http://localhost:8000/docs
INFO:     Application startup complete.

Keep this terminal running!

5 Start Web Server (New Terminal)

Open a new terminal/PowerShell window and run:

cd ElaMCB.github.io/job-search-automation
python -m http.server 8080

Keep this terminal running too!

6 Open Dashboard & Find Jobs!

Visit in your browser:

http://localhost:8080/app.html

1. Click "Upload Resume" and select your resume file
2. Wait for AI to extract your skills
3. Click "Find Matching Jobs"
4. See REAL jobs ranked by how well they match YOUR profile!