ai-file-sorter: Organize and Rename Files with AI

Overview

AI File Sorter is a desktop application for organizing cluttered folders and making filenames more consistent. It uses local or remote language models to suggest categories and names for supported images and documents, and reads embedded metadata to suggest names for supported audio and video files.

The workflow is deliberately review-first: inspect and edit suggestions before approving file moves or renames. Local models can keep files and metadata on your device, making the app a fit for people who want AI-assisted organization without automatically handing control of their files to a service.

Key Features

• Suggests categories and optional subcategories for files, with more refined and more consistent categorization modes.
• Analyzes supported image content with local visual models and can suggest descriptive filenames.
• Extracts text from supported documents for categorization and optional filename suggestions.
• Builds audio and video filename suggestions from supported embedded media metadata.
• Provides a review table, preview or dry-run workflows, editable suggestions, and persistent undo for the last run.
• Supports category whitelists, local caching, and learning from approved review decisions.
• Offers local models for offline processing, as well as remote models configured with user-provided credentials.
• Runs on Windows, macOS, and Linux, with optional CUDA or Vulkan acceleration where available.

Use Cases

• Individuals can bring order to a Downloads folder or photo collection while checking suggested moves before making changes.
• Photographers can create descriptive image names and optionally use available date and place metadata in filename suggestions.
• Teams or professionals can sort mixed document folders using content-based suggestions and a controlled category whitelist.
• Music and video library owners can turn embedded tags into more consistent filenames without applying changes automatically.
• Privacy-conscious users can choose local models when they want analysis to stay on their computer.

Getting Started

Download a release from the GitHub repository or the project website. For a first run, test with a small copied folder and review the proposed changes before applying them. See the README for platform-specific installation instructions and model setup.

Considerations

• AI suggestions can require review and adjustment. The app does not move or rename files until changes are approved.
• Local image and document analysis depends on supported model files and can be resource-intensive. GPU acceleration is optional, not a universal requirement.
• Remote model use requires user-provided credentials and an internet connection. The repository describes local processing as keeping files and metadata on-device.
• Document and media support is format-specific. The README lists supported formats and notes that legacy Office formats such as .doc, .xls, and .ppt are not currently supported.
• The project is licensed under AGPL-3.0. Review the license terms if distributing or modifying the software.