Document scheduled model retraining#4981
Conversation
The Viam app now supports setting a retraining schedule (daily, weekly, or monthly) on ML models trained with a linked dataset. This adds a subsection to the retrain guide describing the feature. Source: viamrobotics/app#11634 (backend scheduler), viamrobotics/app#11635 (frontend UI) https://claude.ai/code/session_01RpYY6JffBD27vcdBPV41vb
✅ Deploy Preview for viam-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
There was a problem hiding this comment.
Pull request overview
Updates the vision model drift/retraining guide to document the newly added “scheduled model retraining” feature available in the Viam app, so users can automate periodic retraining runs from the model details page.
Changes:
- Adds a “Schedule automatic retraining” subsection under “Train a new model version”.
- Documents how to configure daily/weekly/monthly schedules in the UI and notes current limitations (built-in training + linked dataset; no custom training scripts yet).
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ### Schedule automatic retraining | ||
|
|
||
| Instead of manually starting a training job each time you add new data, you can set a retraining schedule on a model. | ||
| Viam checks the schedule daily and submits a new training job when the model is due. |
There was a problem hiding this comment.
The scheduler timing is ambiguous here. Since scheduled retraining is evaluated once per day (per PR description, at midnight UTC), the docs should state the timezone/time-of-day explicitly so users don’t assume local-time scheduling or an immediate retrain after the selected day begins.
| Viam checks the schedule daily and submits a new training job when the model is due. | |
| Viam evaluates retraining schedules once per day at midnight UTC and submits a new training job when the model is due. |
There was a problem hiding this comment.
Fixed in ea74026. Applied the suggestion — added "once per day at midnight UTC" to clarify the evaluation timing.
Generated by Claude Code

Source changes
7060a1b): Model retraining backend scheduler — runs daily at midnight UTC, checks models with a cron-based retraining schedule, and submits new training jobs2446206): Frontend UI for retraining schedule — adds a dialog to the model details page where users set daily, weekly, or monthly retrainingDocs changes
docs/vision/deploy-and-maintain/retrain.md: Added a "Schedule automatic retraining" subsection under "Train a new model version" describing how to set a retraining schedule from the model details page, the available frequencies, and the limitation that custom training scripts are not supportedHow I found these
schedulers/model_retraining_scheduler.goandui/src/lib/api/training-jobs/retraining-schedule.tsfiles in the app repo diffisRetrainablebased on model metadata)retrainacross docs found the existing retrain guide as the natural locationGenerated by daily docs change agent