# checkpoints

Checkpoint files are not included in the submission archive.

## Required files

Place the following files in this folder:

- `mlp_best.pt`
- `xgboost_face_orientation_best.json`
- `scaler_mlp.joblib`
- `hybrid_focus_config.json`
- `hybrid_combiner.joblib`
- `L2CSNet_gaze360.pkl`

## Optional generated files

- `meta_best.npz`
- `meta_mlp.npz`

They are metadata artifacts and are not required for standard inference.

## Download sources

Use any one source:

- Hugging Face Space files: [checkpoints folder](https://huggingface.co/spaces/FocusGuard/final_v2/tree/main/checkpoints)
- ClearML project: [FocusGuards Large Group Project](https://app.5ccsagap.er.kcl.ac.uk/projects/ce218b2f751641c68042f8fa216f8746/experiments)
- Google Drive fallback: [checkpoint folder](https://drive.google.com/drive/folders/15yYHKgCHg5AFIBb04XnVaeqHRukwBLAd?usp=drive_link)

## Verify files

Run from repo root:

```bash
ls -lh checkpoints
```

You should see all required filenames above.

## L2CS lookup order in runtime

The app checks for L2CS weights in this order:

1. `checkpoints/L2CSNet_gaze360.pkl`
2. `models/L2CS-Net/models/L2CSNet_gaze360.pkl`
3. `models/L2CSNet_gaze360.pkl`