Known Issues

PyInstaller

Using Adaptix with PyInstaller may lead to errors such as: Type ‹...› is not recognized as model even when the class is actually supported.

Adaptix relies on package version information provided by importlib.metadata, but PyInstaller removes package metadata by default during the build process.

To fix this, you need to preserve the metadata by using the --copy-metadata PACKAGE_NAME option in PyInstaller. This flag must be applied to every package integrated with Adaptix, for example: --copy-metadata sqlalchemy, --copy-metadata msgspec.