# SlothSort: a local-first file organizer for people who would rather not sort files

Title: SlothSort: Simplifying Local File Organization for Busy Users

SlothSort is a Python command-line tool designed to help users manage their files without the hassle of manually sorting them into appropriate folders. Created for the Hacktoberfest Open-Source AI Challenge Week 3, this app is ideal for those who would rather not sort files but still want a tidy Downloads folder.

The tool sorts files into folders such as Documents, Images, Videos, Audio, Code, and Archives. Users can preview a cleanup, organize the files in one pass, or watch for new files and sort them after they finish downloading. SlothSort skips hidden and temporary files, avoids overwriting duplicate names, and never opens file contents.

To use SlothSort, simply run the command python main.py followed by the path to your Downloads folder. You can add the --dry-run option to preview proposed moves, or the --once or --watch options to organize the folder once or watch for new files, respectively.

SlothSort is a local command-line app, not a hosted web page. It uses Ollama, a local AI service, to classify file names based on filename and extension rules. If Ollama is unavailable or does not return a recognized category, SlothSort will fall back to its built-in rules. The tool is written in Python and can be run from a terminal without the need for a hosted AI API.

The project's source code is available on GitHub, and users can install the required Python dependencies using pip install -r requirements.txt. To run the local model classification, install Ollama and pull the gemma3:4b model with ollama pull gemma3:4b. Even without the Ollama model, SlothSort's built-in rules ensure that users can still organize their files effectively.