echoyu1025-a11y/file-butler — explained in plain English
Analysis updated 2026-05-18
Let an AI read the contents of files in a messy folder and suggest a clean category structure.
Scan a folder to find duplicate files, junk files, and oversized files worth deleting manually.
Run entirely offline with a local AI model to keep personal files private.
| echoyu1025-a11y/file-butler | jdduke/fpcpp | lagerpun/esp32-cyd-aquarium | |
|---|---|---|---|
| Stars | 21 | 21 | 21 |
| Language | C++ | C++ | C++ |
| Last pushed | — | 2012-06-01 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | easy | easy | moderate |
| Complexity | 2/5 | 2/5 | 2/5 |
| Audience | general | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Prebuilt installers for macOS and Windows are unsigned, so first launch needs a security bypass step.
File Butler is a desktop app for macOS and Windows that uses AI to help clean up a messy folder. It is a customized version of an open source project called AI File Sorter, and it can run entirely offline if you use a local AI model. It has two main features. The first is file organizing: you point it at a folder, and the AI reads the actual contents of each file, not just the file name, then suggests a category and a clearer file name for it. You can preview every suggested change before anything happens, run it in a dry-run mode that only shows results without touching files, and undo changes afterward. By default it only creates one level of category folders so things do not get scattered into too many small folders. The second feature is file cleanup, which scans a folder and reports four kinds of files that are probably safe to remove: junk or cache files like temporary and log files, duplicate files found by comparing file content rather than just names, large files over 100 megabytes, and empty folders or zero-byte files. The app is careful to only report and locate these files. It never deletes or moves anything on its own, and instead lets you click through to the file's location and decide for yourself. For the AI step, you can either download a local language model such as Gemma 3 4B, which keeps everything private and free, or connect a cloud service like ChatGPT or Gemini using your own API key. The interface supports fifteen languages and defaults to Simplified Chinese in this fork. This project is aimed at everyday computer users who want an AI assisted way to tidy up cluttered folders without giving up control over what actually gets deleted.
File Butler is a desktop app that uses local or cloud AI to suggest file organization and flag junk, duplicate, and large files, without ever deleting anything itself.
Mainly C++. The stack also includes C++, Qt, SQLite.
Based on AGPL-3.0, which requires sharing source code of modified versions, including when run as a network service.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.