Repolode
Submit
hyperfield

hyperfield/ai-file-sorter

Cross-platform desktop app that uses local or remote LLMs to categorize files and suggest clearer names, with a review step before any change.

View on GitHubWebsite
Stars
1,839
Forks
185
Open issues
28
Last commit
23 hours ago

What is it?

AI File Sorter is a desktop application for organizing cluttered folders such as Downloads, external drives, or NAS storage. It assigns each file a category and optional subcategory using an AI model, and for supported file types it proposes a cleaner filename. Images are analyzed by content with a visual LLM, documents are summarized from their text, and audio and video files can be renamed from embedded tags such as artist, album, and title.

You can run everything on your own machine with a local GGUF model, in which case files and metadata never leave the computer and no telemetry is sent. Remote models from OpenAI, Gemini, or any OpenAI-compatible endpoint are also supported with your own credentials. Whitelists, cached results, and approved review decisions help keep categories consistent across runs.

Nothing is moved or renamed until you review the results. The app offers a preview and dry-run mode, a review table with editable suggestions, and a persistent Undo for the last run. The interface is built with Qt6 and runs on Windows, macOS, and Linux.

Key features

  • 01Categorizes files into folders and subfolders using local or remote LLMs
  • 02Analyzes image content with a visual model and suggests descriptive filenames
  • 03Summarizes document text (PDF, Office, plain text formats) to propose names
  • 04Renames audio and video files from embedded metadata tags
  • 05Supports category whitelists to constrain output to a chosen vocabulary
  • 06Preview, dry-run, and persistent undo before and after applying changes

Use cases

  • Tidying a messy Downloads folder full of mixed documents, images, and installers
  • Renaming camera or screenshot files like IMG_2048.jpg into descriptive names
  • Organizing a music or video library by cleaning up filenames from tags
  • Sorting files on a NAS or external drive while keeping data on a local model

Quick start

  1. 1

    Download the app from SourceForge or the Microsoft Store

  2. 2

    Start with a small test folder of 20-50 files and review the suggestions before applying changes

Things to know

  • Remote models require an internet connection and your own API key; fully offline use needs a local model.
  • Licensed under AGPL-3.0, a copyleft license that requires derivative works to be shared under the same terms.
  • Available category languages depend on the selected local model.

Topics

#file-management#llm#desktop-app#file-organizer#local-llm#image-analysis#cross-platform#qt#ai#file-manager

FAQ

What is ai-file-sorter?
Cross-platform desktop app that uses local or remote LLMs to categorize files and suggest clearer names, with a review step before any change. AI File Sorter is a desktop application for organizing cluttered folders such as Downloads, external drives, or NAS storage. It assigns each file a category and optional subcategory using an AI model, and for supported file types it proposes a cleaner filename. Images are analyzed by content with a visual LLM, documents are summarized from their text, and audio and video files can be renamed from embedded tags such as artist, album, and title.
Is ai-file-sorter free to use? What license does it have?
ai-file-sorter is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is ai-file-sorter still maintained?
Actively maintained. The last commit to ai-file-sorter was on Oct 19, 2026.
What can I use ai-file-sorter for?
Tidying a messy Downloads folder full of mixed documents, images, and installers Renaming camera or screenshot files like IMG_2048.jpg into descriptive names Organizing a music or video library by cleaning up filenames from tags Sorting files on a NAS or external drive while keeping data on a local model
How do I install ai-file-sorter?
Download the app from SourceForge or the Microsoft Store Start with a small test folder of 20-50 files and review the suggestions before applying changes
Where can I get ai-file-sorter?
The source code and installation instructions are on GitHub: https://github.com/hyperfield/ai-file-sorter

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects