AI 3D Sorter is a script for automatic sorting of 3D models into library folders using AI. It analyzes the file name and preview image of the model, determines the object's category, and moves the model to the corresponding folder. The script is launched using the file ai_3d_sorter_current.bat. All information regarding the script's operation is contained in the docs folder, file AI_3DSorter_QuickStart_Guide.pdf.

Requirements for the script to work:
AI 3D Sorter requires LM Studio to be installed and the AI model Qwen3-VL to be downloaded locally. The script does not contain a built-in AI model and does not work by itself without a running local LM Studio server. The user must independently install LM Studio, download the model qwen/qwen3-vl-8b, load it into LM Studio, and enable the server in the Developer tab. Recommended model: qwen/qwen3-vl-8b. LM Studio must be running, the model must be loaded, and the local server must have the status Running. By default, the script waits for a connection to LM Studio at: http://127.0.0.1:1234.  Before sorting, it is recommended to click the "Check LM Studio" button in the AI 3D Sorter interface. If the model and server are configured correctly, the script will confirm the connection readiness.

How the script processes model files:
AI 3D Sorter works with file bundles that have the same main name. Usually, such a bundle consists of the model archive and the preview image. The script considers such a pair as one model: the archive is used as the main model file, and the preview image is for visual analysis and category determination. If additional files with the same name are next to the archive and are not part of the working model bundle, they may be deleted during processing. This is done to clean up unnecessary files and maintain an orderly library structure. If multiple preview images are found for one model, the script selects one image for analysis and sorting. The other preview files of this model are deleted as duplicates. All deleted files are placed in the _Trash folder in the library tree.

Before the first real launch, it is recommended to use the test mode and ensure that the script correctly identifies pairs of "archive + preview." If there are important additional files in the folder, it is better to make a backup of the original folder in advance.

Key features:
1. Automatic sorting of 3D models by categories.
2. Analysis of the file name and preview image of the model.
3. Recognition of models even with alphanumeric or uninformative file names if a preview image is nearby.
4. Support for standard and custom library structures.
5. Creation of a default library folder structure.
6. Mapping user folders to default library categories.
7. Ability to map multiple standard categories to one custom folder.
8. Library editor for configuring categories, paths, and AI hints.
9. Test mode for checking sorting before actual file transfer.
10. Manual review and adjustment of sorting results by double-clicking in the path field of each model.
11. Detailed sorting logs with descriptions of the object, selected category, and final path.
12. Support for Russian and English interface languages.
13. Support for dark and light themes.
14. Batch processing of a large number of models.
15. Actual moving of files across library folders.
16. Enlarging the preview image by double-clicking with window closing by Esc.