Sloth AI Folder Tidier: Let Open-Source AI Clean Your Downloads Folder So You Don't Have To

A developer built Sloth AI Folder Tidier, a Python CLI that uses open-weight models (qwen/qwen3.8-27b and openai/gpt-oss-20b via the Groq API) to sort cluttered Downloads folders into logical categories by reading file metadata and 150-character previews. The tool batches 15 files per request with forced JSON output, enforces a zero-deletion policy, quarantines untouched installers and archives into a vault, and logs every move to a state file for one-command undo. The developer reports it organized 962 accumulated files across 65 batches in seconds.

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady https://dev.to/challenges/hacktoberfest-week3-2026-10-19 What I Built Let’s be honest about the Downloads folder. For most developers and students, it is a digital graveyard. Mine had accumulated exactly 962 files—a chaotic mix of university PDFs, C snippets, .jar game mods, audio tracks, and 40 different setup v2 final 1 .exe installers. Why don't I clean it? Because of the Hoarder’s Paradox: I am way too lazy to sort nearly a thousand files manually. I am too paranoid to bulk-delete anything because "what if I need that random file from 4 months ago? " To channel my inner sloth for International Sloth Day, I built Sloth AI Folder Tidier—an automated file organizer designed specifically for lazy digital hoarders. Instead of blindly sorting by file extension, it scans file age, size, and peeks at the first 150 characters of text/code files. Using open-weight models, it understands context and neatly organizes chaos into logical folders University & Docs, Code & Dev, Gaming & Mods, Media & Music, etc. with three golden safety rules: Zero-Deletion Policy: The script literally does not contain a delete function. Nothing is ever lost. The Sloth Vault Sloth Vault Old : If an installer or archive hasn't been touched in over 30 days, the AI quarantines it. Out of sight, out of mind, but still there if you panic. 1-Click Undo --undo & Dry-Run --dry-run : Every move is logged locally. One command reverts your entire folder back to its original messy state in 1 second. Demo Code How I Built It The project is a Python CLI built around fast, open-weight models qwen/qwen3.8-27b and openai/gpt-oss-20b running via the Groq API. Metadata & Micro-Context Extraction: Rather than uploading whole files, the script uses pathlib and os.stat to extract lightweight metadata filename, extension, age in days, size and reads a tiny 150-character preview for plain-text/code files. Structured JSON Batching: To process hundreds of files efficiently without hitting rate limits, the script chunks the files into batches of 15. These are passed to the model with response format={"type": "json object"}, forcing the open-weight model to act as a deterministic routing engine rather than a chatty assistant. State Reversibility: Every shutil.move operation is recorded in a sloth history.json state file, allowing deterministic rollback. Why Does Open Innovation Matter? When building a tool that inspects your personal filesystem, open-source AI isn't just a nice-to-have — it’s mandatory: Privacy of Personal Files: Nobody wants to send a list of their private university documents, local source code, and personal filenames to a closed, proprietary corporate cloud that trains on user prompts. Because this architecture uses standard open-weight models, you can run it via fast zero-retention APIs like Groq or eventually swap the base URL to run it 100% offline via Ollama. Set It and Forget It Zero Cost : A folder tidier is a background utility you run weekly. Using highly capable, smaller open models means inference is practically free, allowing a true "set it once and be lazy forever" workflow. Model Swappability: Closed APIs lock you in. While building this, several models were decommissioned on my inference provider. Because I was using open models, I simply swapped my array from gemma2-9b-it to qwen3.8-27b and gpt-oss-20b in exactly five seconds without rewriting a single line of parsing logic. The Lazy Payoff I am my own first user. My Downloads folder had 962 files spanning over a year of university assignments and freelance coding projects. Sorting that manually would have taken at least an hour of tedious dragging and dropping. With this script, I typed one command, leaned back, and watched the AI process 65 batches in a few seconds. My folder is completely clean, my old installers are quarantined in the vault, and I didn't have to lift a finger or make a single decision. Pure sloth perfection