checkpoints/README.md

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
• ClearML project: FocusGuards Large Group Project
• Google Drive fallback: checkpoint folder

Verify files

Run from repo root:

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