●Change8

Migrating to InvokeAI v6.9.0rc1

Version v6.9.0rc1 introduces 2 breaking changes. This guide details how to update your code.

Released: 10/15/2025

2
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.

●Issue #2

Manually adding models to the Invoke-managed models directory no longer automatically registers them in Invoke; the database must be used for registration.

Migration Steps

  1. 1
    On first run after installing this release, Invoke will perform data migrations: database updates and restructuring of Invoke-managed model directories to the new flat, UUID-based folder structure.
  2. 2
    If you encounter issues after 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 refactoring model identification logic and changing the internal storage structure for Invoke-managed models to a flat, UUID-based directory system. A data migration is performed on first run to adapt existing models to the new structure.

Need More Details?

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

View Full Changelog