ai-file-sorter
Cross-platform desktop application for content-aware file organization and renaming. Supports local and remote LLMs, preview-based workflows, and fully user-con
What is ai-file-sorter?
Cross-platform desktop application for content-aware file organization and renaming. Supports local and remote LLMs, preview-based workflows, and fully user-controlled changes.
Overview of ai-file-sorter
What it is
AI File Sorter is a cross-platform desktop application that uses AI to organize files and suggest cleaner, more consistent names for images, documents, and supported audio/video files. It is designed to reduce clutter, improve consistency, and make files easier to find later, whether for review, archiving, or long-term storage. The app can analyze picture files locally with built-in visual LLM backends and suggest meaningful, human-readable names. It can also analyze supported document files and propose clearer names based on their text content. For audio/video files, it uses metadata such as year, artist, album, or title to generate suggestions. AI File Sorter is privacy-first by design: it can run entirely on your device with local models, and no telemetry is sent. An internet connection is only needed if you choose to use a remote model.
Key features
- AI-powered categorization: Sort files using either local AI models on your computer or remote models with your own API key.
- Offline-friendly: Use a local LLM to categorize files entirely without internet or API key required.
- Configurable categorization controls: Use whitelists, taxonomy normalization, consistency modes, and review-time edits to steer categories and subcategories.
- Two categorization modes: Pick More Refined for more specific labels or More Consistent for steadier top-level categories across similar files.
- Category whitelists: Define named whitelists to restrict allowed categories and subcategories.
- Preview-based workflow: Review and adjust suggestions before any move or rename is applied.
- Privacy-first: Files, filenames, images, and metadata stay on your computer when using local models.
Use cases
- Tidy up cluttered folders such as Downloads, external drives, or NAS storage.
- Group files based on names, file types, folder context, and past sorting results.
- Improve file naming consistency for archiving or long-term storage.
- Review and approve AI suggestions before applying changes, reducing risk.
Getting started
See the repository README for installation and quick-start instructions.
License and pricing
License: AGPL-3.0. Pricing: open source (free).
Based on the project's public README and repository metadata.
