# 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.

Repository: https://github.com/hyperfield/ai-file-sorter
Canonical: https://ross.abutalabs.com/products/ai-file-sorter
Homepage: https://filesorter.app
Language: C++
License: AGPL-3.0
License Family: copyleft
Topics: ai, file-management, file-manager, llm, organizer
Last push: 2026-08-16T14:41:15+00:00

## Health v2 (maintenance only)
Score: 87/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 98, longevity 41
- inputs: {"age_days": 580, "days_push": 17, "days_rel": 19, "gap_med": 13.5, "n_releases_24m": 19}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1564, forks 161 (observed 2026-08-28T04:05:03.306828+00:00)

## What it is
AI File Sorter is a cross-platform desktop application that uses local or remote LLMs to categorize files and suggest cleaner filenames for images, documents, and media. It offers preview-based review workflows, dry runs, persistent undo, and fully offline inference with built-in models like Gemma 3 4B IT.

## Use cases
- organize messy downloads folder with ai
- rename photos with descriptive names automatically
- sort files into folders using local llm offline
- clean up filenames from audio video metadata
- batch rename documents based on their content
- preview and undo file moves before applying

## When to choose
- you want fully offline, private AI file organization with local models
- you need review-first workflows with dry run, previews, and undo
- you want a GUI app that works on Windows, macOS, and Linux
- you want to bring your own OpenAI or Gemini API key instead of local models

## When to avoid
- you need rule-based automation or scripted bulk file operations without AI
- you want a headless CLI tool for server-side file pipelines
- your files are in unsupported formats the app cannot analyze

## Facets
- artifact type: application
- maturity: active
- function: llm-inference, file-system, image-processing, nlp
- domain: files, artificial-intelligence, developer-tools, desktop-applications
- platform: windows, cross-platform, cpp
- tags: file-organizer, file-renaming, local-llm, gguf, privacy, offline-ai, dry-run, undo, gemma, mistral, macos, linux, desktop

## Member repositories
- hyperfield/ai-file-sorter (main) score 87

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:03.306828+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:00:13.519579+00:00, confidence not recorded.
  - readme: https://github.com/hyperfield/ai-file-sorter (fetched 2026-08-28T04:05:03.306828+00:00, sha 65adfa8c6404)
  - homepage: https://filesorter.app (fetched 2026-08-29T11:29:02.520623+00:00, sha 8bfd8ad01a5a)
  - site_page: https://filesorter.app/changelog (fetched 2026-08-29T11:29:02.529710+00:00, sha 01e40c84f3d0)
  - site_page: https://filesorter.app/faq (fetched 2026-08-29T11:29:02.531977+00:00, sha 3c8751795e27)
- Data as of 2026-08-30T08:39:29.467469+00:00.