hyperfield/ai-file-sorter

What it solves

AI File Sorter is a cross-platform desktop application designed to eliminate digital clutter by automatically organizing files into categories and suggesting descriptive, human-readable filenames. It solves the problem of messy folders (like Downloads or external drives) where files have generic names (e.g., IMG_2048.jpg) or lack a consistent structure.

How it works

Users point the app at a folder or drive, and the software analyzes the files using either local or remote AI models. For images, it uses a Visual LLM to describe the content; for documents, it uses a Text LLM to summarize content; and for audio/video files, it extracts embedded metadata. The app then generates category and rename suggestions, which the user reviews and adjusts in a table before confirming the changes to automatically create folders and move files.

Who it’s for

It is for users who want to tidy up large archives of photos, documents, and media files while maintaining privacy (via local models) and having full control over how files are renamed and sorted.

Highlights

• Privacy-First: Can run entirely offline using local LLMs (like Gemma 3 4B IT) so no data leaves the computer.
• Multimodal Analysis: Uses visual models for images and text models for documents to suggest meaningful names.
• Flexible Categorization: Offers "More Refined" (specific) and "More Consistent" (broad) modes, along with customizable whitelists to constrain folder names.
• Safety Features: Includes a dry-run preview, a persistent "Undo last run" feature, and project-folder protection to avoid breaking source-code repositories (e.g., Git, Unity, Unreal).
• Cross-Platform: Compatible with Windows, macOS, and Linux.