To start this project: Create env in repo root (python -m venv .venv && source .venv/bin/activate) and install deps (pip install -r requirements.txt). Python 3.10+ recommended.

Rename .env.example to .env and add your key: OPENAI_API_KEY=....

HF_HUB_OFFLINE/TRANSFORMERS_OFFLINE are set to stay offline; clear them if you need to download weights.

If you need a one-time download, then restart: export HF_HUB_OFFLINE=0 TRANSFORMERS_OFFLINE=0

Start the embedding server (FastAPI + UI) from python embedding_service/embedding_server.py