← all repositories
hyperfield/ai-file-sorter

A desktop app that lets an LLM reorganize your files—locally

AI File Sorter brings order to cluttered folders by using local or remote LLMs to categorize and rename images, documents, and media based on their actual content, with full manual review before anything moves.

1.3k stars C++ Domain AppsAgents
ai-file-sorter
Velocity · 7d
+3.6
★ / day
Trend
cooling
star history

What it does

AI File Sorter is a C++ / Qt6 desktop application for Windows, macOS, and Linux that scans folders and proposes new names and categories for your files. It handles images via built-in visual LLMs like Gemma 3 4B IT, reads documents with text LLMs, and cleans up audio and video filenames using embedded metadata tags. Every proposed move appears in a preview table for your approval before the app touches the filesystem.

The interesting bit

The app keeps categorization consistent across runs by blending raw LLM output with taxonomy normalization, session consistency hints, and a local cache of your past approved decisions—essentially building a lightweight, private feedback loop without retraining the model. It can run entirely offline using bundled GGUF backends, and it will only reach for a remote API if you explicitly plug in your own key.

Key highlights

  • Runs fully offline with local visual and text models (Gemma 3 4B IT, LLaVA 1.6 Mistral 7B, or custom GGUFs) and sends no telemetry.
  • Supports remote models via your own OpenAI, Gemini, or OpenAI-compatible API credentials.
  • Offers two categorization modes: More Refined for detailed labels or More Consistent to keep folders uniform.
  • Lets you constrain the model with category whitelists and review edits before any rename or move is applied.
  • Includes persistent undo, dry-run previews, and a local learned-hints database that improves future suggestions based on your past approvals.

Verdict

Worth a look if your Downloads folder or NAS has become an unnavigable soup of generic filenames and you want a private, review-first cleanup tool. Skip it if you already have a rigid naming convention and zero interest in LLM suggestions.

Frequently asked

What is hyperfield/ai-file-sorter?
AI File Sorter brings order to cluttered folders by using local or remote LLMs to categorize and rename images, documents, and media based on their actual content, with full manual review before anything moves.
Is ai-file-sorter open source?
Yes — hyperfield/ai-file-sorter is open source, released under the AGPL-3.0 license.
What language is ai-file-sorter written in?
hyperfield/ai-file-sorter is primarily written in C++.
How popular is ai-file-sorter?
hyperfield/ai-file-sorter has 1.3k stars on GitHub and is currently cooling off.
Where can I find ai-file-sorter?
hyperfield/ai-file-sorter is on GitHub at https://github.com/hyperfield/ai-file-sorter.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.