●Change8

Migrating to InvokeAI v6.9.0rc2

Version v6.9.0rc2 introduces 1 breaking change. This guide details how to update your code.

Released: 10/15/2025

1
Breaking Changes
3
Migration Steps
0
Affected Symbols

Breaking Changes

●Issue #1

The internal model storage directory structure for Invoke-managed models has changed from nested folders (<models_dir>/<type>/<base>/model.safetensors) to a flat structure where each model resides in its own UUID-named folder (<models_dir>/<model_key_uuid>/model.safetensors). This requires a data migration on first run.

Migration Steps

  1. 1
    On first run after installing this release, Invoke will perform data migrations, including updating model records and restructuring the Invoke-managed models directory to the new flat structure.
  2. 2
    If you encounter errors during migration, create a GH issue or seek help in the #new-release-discussion channel on Discord.
  3. 3
    Users on older GPUs (20xx and 10xx series) may experience issues installing/updating due to recent torch updates; manual downgrading of torch might be necessary.

Release Summary

This release significantly improves Invoke's Model Manager by restructuring internal model storage to a flat, UUID-based directory and refactoring the model identification system. A key user-facing change is that previously unidentified models are now installed as 'Unknown' rather than being deleted.

Need More Details?

View the full release notes and all changes for InvokeAI v6.9.0rc2.

View Full Changelog