hopeIsCo0l/ea-cv-job-matcher

Standalone Phase-1 AI service for Ethiopian Airlines CV-to-job similarity using TF-IDF + cosine scoring, deterministic ranking, evaluation artifacts, and FastAPI API contract. # Ethiopian Airlines CV-to-Job Similarity Production-ready baseline AI service for matching one CV to Ethiopian Airlines jobs using **TF-IDF + cosine similarity**. Release tag: `v1.0.0-phase1-baseline` ## What this delivers - FastAPI service with `POST /v1/score` - Ethiopian Airlines-only domain filtering - Hard cap of 8 jobs per scoring run - Deterministic ranking with lightweight explainability (`top_terms`) - Synthetic evaluation pipeline with artifacts - Dockerized local run ## Quickstart ### 1) Install ```bash python -m venv .venv # Windows PowerShell .\.venv\Scripts\Activate.ps1 pip install -e .[dev] ``` ### 2) Run API ```bash uvicorn src.api.main:app --host 0.0.0.0 --port 8000 ``` ### 3) Run tests ```bash pytest ``` ### 4) Run Phase 1 evaluation ```bash python scripts/generate_synthetic_data.py python scripts/run_evaluation.py ``` ### 5) Run Phase 2 data and quality pipeline ```bash python scripts/run_phase2_pipeline.py ``` ### 6) Phase 3 — train candidates vs same TF-IDF features (comparison table) ```bash python scripts/run_phase3_comparison.py ``` See `docs/phase3-training-plan.md`. Outputs: `artifacts/phase3_comparison_table.md`, `artifacts/phase3_comparison.json`, `artifacts/phase3_models/`. ## One-command local run (Docker) ```bash docker compose up --build ``` ## Sample request ```bash curl -X POST "localhost" \ -H "Content-Type: application/json" \ -d '{ "cv_text": "Customer-focused graduate with airport operations internship and flight handling exposure.", "jobs": [ { "job_id": "et-ground-001", "title": "Trainee Ground Operations Officer", "description": "Coordinate ramp operations, baggage handling, and turn-around tasks.", "company_name": "Ethiopian Airlines" }, { "job_id": "et-cabin-001", "title": "Trainee Cabin Crew", "description": "Deliver in-flight passenger service and ensure onboard safety.", "company_name": "Ethiopian Airlines" } ] }' ``` ## Outputs - `artifacts/synthetic_dataset.json` - `artifacts/eval_res …