{"name":"AI File Sorter: Organize Your Files with Local AI and Visual LLMs","description":"AI File Sorter is a powerful cross-platform desktop application designed to automate file organization using AI. It leverages local LLMs for privacy-first categorization and can even suggest better filenames for images based on their visual content. This tool helps reduce clutter and improve file discoverability across various storage locations.","github":"https://github.com/hyperfield/ai-file-sorter","url":"https://osrepos.com/repo/hyperfield-ai-file-sorter","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/hyperfield-ai-file-sorter","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/hyperfield-ai-file-sorter.md","json":"https://osrepos.com/repo/hyperfield-ai-file-sorter.json","topics":["ai","file-management","llm","file-organizer","desktop-app","c++","privacy-first"],"keywords":["ai","file-management","llm","file-organizer","desktop-app","c++","privacy-first"],"stars":null,"summary":"AI File Sorter is a powerful cross-platform desktop application designed to automate file organization using AI. It leverages local LLMs for privacy-first categorization and can even suggest better filenames for images based on their visual content. This tool helps reduce clutter and improve file discoverability across various storage locations.","content":"## Introduction\n\nAI File Sorter is a powerful, cross-platform desktop application designed to automate file organization using artificial intelligence. It intelligently categorizes files and can even suggest more descriptive filenames for images by analyzing their visual content. Built with a privacy-first approach, the application primarily uses local LLMs (Large Language Models) like LLaMa and Mistral, ensuring that your files and data never leave your device. It aims to reduce digital clutter, improve consistency, and make your files easier to find for review, archiving, or long-term storage.\n\n## Installation\n\nGetting started with AI File Sorter is straightforward. For most users, the easiest way is to use the prebuilt packages or installers available for your operating system.\n\n*   **Linux:** Prebuilt Debian/Ubuntu packages are available, which can be installed using `sudo apt install ./aifilesorter_1.0.0_amd64.deb` after installing runtime prerequisites.\n*   **macOS:** Users can install dependencies via Homebrew and then build from source, or use provided binaries.\n*   **Windows:** The recommended method involves using CMake with vcpkg, or the Qt online installer, after setting up Visual Studio 2022.\n\nDetailed instructions for building from source and specific dependencies for various Linux distributions are available in the official GitHub repository.\n\n## Examples\n\nUsing AI File Sorter involves a simple, guided process:\n\n1.  **Select a Directory:** Point the application to the folder or drive you wish to organize.\n2.  **Analyze Files:** The app scans files, and for images, analyzes their content locally using a visual LLM.\n3.  **Review Suggestions:** A review dialog presents suggested categories, subcategories, and optional filename changes for images. You can sort, adjust, or approve these suggestions.\n4.  **Confirm & Sort:** With \"Dry run (preview only, do not move files)\" enabled, you can inspect planned moves without altering your files. Once satisfied, click \"Confirm & Sort!\" to execute the organization.\n5.  **Undo Last Run:** The application saves a persistent undo plan, allowing you to revert the last sorting operation via \"Edit ? Undo last run\" if needed.\n\nKey features include customizable sorting rules, two categorization modes (\"More refined\" for detail or \"More consistent\" for uniformity), and the ability to define category whitelists to constrain model output.\n\n## Why Use It\n\nAI File Sorter stands out for several compelling reasons:\n\n*   **Intelligent Automation:** Moves beyond rigid rules, learning your organization patterns over time to provide more consistent and relevant categorization and naming suggestions.\n*   **Privacy-First:** By utilizing local LLMs, it ensures that your sensitive files, filenames, images, and metadata are processed entirely on your device, with no data uploaded or telemetry sent.\n*   **Enhanced Discoverability:** Reduces clutter and applies meaningful names, making it significantly easier to locate files later.\n*   **Cross-Platform Support:** Available on Windows, macOS, and Linux, providing a consistent experience across different environments.\n*   **Flexibility and Control:** Offers various categorization modes, category whitelists, and the option to use remote LLMs (like ChatGPT or Gemini) with your own API keys for advanced scenarios, while always requiring your approval before any changes are applied.\n*   **Visual Content Analysis:** A unique feature that analyzes image content to suggest descriptive filenames, transforming generic names into something meaningful.\n\n## Links\n\n*   **GitHub Repository:** [https://github.com/hyperfield/ai-file-sorter](https://github.com/hyperfield/ai-file-sorter){:target=\"_blank\"}\n*   **Download from SourceForge:** [https://sourceforge.net/projects/ai-file-sorter/files/latest/download](https://sourceforge.net/projects/ai-file-sorter/files/latest/download){:target=\"_blank\"}\n*   **Get it from Microsoft Store:** [https://apps.microsoft.com/detail/9npk4dzd6r6s](https://apps.microsoft.com/detail/9npk4dzd6r6s){:target=\"_blank\"}\n*   **Support AI File Sorter (Donate):** [https://filesorter.app/donate](https://filesorter.app/donate){:target=\"_blank\"}","metrics":{"detailViews":4,"githubClicks":4},"dates":{"published":null,"modified":"2026-01-24T20:01:20.000Z"}}