hopeIsCo0l/ea-cv-job-matcher
Record type:
software
Creator:
hop
Host:
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 …