| name | cvat-deploy |
| description | Deploy a trained YOLO model as a Nuclio serverless function for CVAT auto-annotation. |
Deploy Model to CVAT
Deploy a trained YOLO model as a Nuclio serverless function so CVAT
users can auto-annotate images directly from the CVAT UI.
Pre-Flight Checklist
Workflow
1. Identify the Model
- Use the best model from the latest experiment, or ask the user
- Check
experiments/summary.md for the best-performing model path
2. Generate Nuclio Function
yolo-cvat deploy --model <path_to_model> --name <detector_name>
This generates:
serverless/<name>/function.yaml โ Nuclio config with class spec
serverless/<name>/main.py โ Inference handler
serverless/<name>/best.onnx โ Exported model
3. Verify Generated Files
Read the generated function.yaml and confirm:
- Class names match
yolo-project.yaml
- Image name is unique
- ONNX model was exported correctly
4. Deploy to Nuclio
Provide the command for the user to run:
nuctl deploy --path ./serverless/<name> --platform local
5. Verify Deployment
nuctl get functions
Check that the function is running.
Decision Tree
Model is .pt format?
โโโ Yes โ Export to ONNX first (yolo-export)
โโโ Already .onnx โ Copy directly
Nuclio reachable on port 8070?
โโโ Yes โ Ready to deploy
โโโ No โ Warn user, suggest checking Docker and CVAT stack
Function with same name exists?
โโโ Yes โ Ask user: overwrite or use different name?
โโโ No โ Deploy normally
Guardrails
- NEVER deploy without confirming class mapping matches CVAT project labels
- ALWAYS verify the ONNX export succeeded before deploying
- Document the deployed model version and metrics in experiments/
- If deployment fails, show the Nuclio dashboard URL for debugging (http://localhost:8070)