hyperfield/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.

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 more descriptive, human-readable filenames. It solves the problem of messy Downloads folders, external drives, and NAS storage where files have generic or inconsistent names (e.g., IMG_2048.jpg).

How it works

The app analyzes files using either local or remote Large Language Models (LLMs). It processes different file types using specific strategies:

  • Images: Uses a visual LLM (like Gemma 3 4B IT) to analyze the actual content of the image and suggest a descriptive name (e.g., clouds_over_lake.jpg).
  • Documents: Extracts text from supported formats (PDF, Office, Plain Text) and uses a text LLM to summarize content and suggest filenames.
  • Audio/Video: Reads embedded metadata tags (artist, album, year) to generate clean, library-style filenames.
  • Categorization: Combines LLM output with taxonomy matching, whitelists, and local caching to group files into folders.

Users review all suggested categories and renames in a table before confirming the changes, ensuring no files are moved or renamed without permission.

Who it’s for

It is for users who want to tidy up large volumes of files across Windows, macOS, and Linux, particularly those who prioritize privacy (via local-only execution) or those managing large media and document archives.

Highlights

  • Privacy-First: Can run entirely offline using local GGUF models (e.g., Gemma 3, Mistral) with no telemetry.
  • Visual Analysis: Built-in support for visual LLMs to describe image content, including specialized handling for screenshots and UI captures.
  • Flexible Categorization: Offers "More Refined" or "More Consistent" modes and allows the use of custom category whitelists.
  • Safety Features: Includes a sorting preview, a dry-run mode, and a persistent "Undo last run" feature.
  • Broad Compatibility: Supports a wide range of document, audio, and video formats across multiple operating systems.