Tutor Finder (Django + Streamlit)

This repo implements the lab in basharat_aipd_challenge1.md using the dataset structure in data.csv.

Run locally (recommended)

1) Create a virtualenv and install dependencies

On Windows PowerShell from the repo root:

py -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

2) Start Streamlit (UI)

streamlit run app.py

Open: http://localhost:8501

3) Start Django (landing page + JSON API)

In a second terminal (repo root, venv activated):

python backend\manage.py runserver

Open: http://localhost:8000

API: http://localhost:8000/api/tutors

Run with Docker (optional)

Streamlit only

docker build -t tutor-finder .
docker run --rm -p 8501:8501 tutor-finder

Django + Streamlit together

docker compose up --build

• Django: http://localhost:8000
• Streamlit: http://localhost:8501