●Change8

Migrating to InvokeAI v6.9.0rc3

Version v6.9.0rc3 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: database updates and restructuring of Invoke-managed model directories into a 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 may be necessary.

Release Summary

This release significantly improves Invoke's Model Manager by refactoring model identification, introducing support for installing unknown models, and normalizing the internal model directory structure to a flat, UUID-based layout.

Need More Details?

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

View Full Changelog