The latest articles on DEV Community by Ishanka Batawala (@ishankabatawala). https://dev.to/ishankabatawala https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4175926%2F9ab03ad5-7b0c-4ac2-8c6a-77f83b7bb023.jpg https://dev.to/ishankabatawala en Ishanka Batawala Mon, 26 Oct 2026 06:57:06 +0000 https://dev.to/ishankabatawala/file-butler-the-sloth-inspired-ai-directory-organizer-2fah https://dev.to/ishankabatawala/file-butler-the-sloth-inspired-ai-directory-organizer-2fah <p><em>This is a submission for the <a href="https://dev.to/challenges/hacktoberfest-week3-2026-10-19">Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady</a></em></p> <h2> What I Built </h2> <p>File Butler is an intelligent, Python-based directory organizer that channels your inner sloth by automating the tedious task of sorting messy folders (like your Downloads or Desktop). When pointed at a target directory, File Butler scans the files and subfolders, uses an open-weight model to determine a clean taxonomic folder structure, and safely moves everything into its proper place, saving you hours of manual sorting.</p> <h2> Demo </h2> <p><a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F0ly41a7s008agvmm5i3x.gif" class="article-body-image-wrapper"><img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F0ly41a7s008agvmm5i3x.gif" alt=" " width="720" height="405"></a></p> <h2> Code </h2> <p><em>GitHub Repository:</em> <a href="https://github.com/ishanka-batawala/file-butler" rel="noopener noreferrer">File Butler</a></p> <h2> How I Built It </h2> <p>File Butler is built using pure Python (<code>pathlib</code>, <code>shutil</code>, and <code>argparse</code>) and is powered by an open-weight model (<code>openai/gpt-oss-20b</code>) via the <strong>Groq API</strong>.</p> <ul> <li> <strong>Directory Scanner:</strong> Inspects loose files and subfolders while bypassing hidden system files.</li> <li> <strong>AI Taxonomy Engine:</strong> Sends a lightweight JSON map of the directory structure to the open-weight model to generate a logical categorization plan.</li> <li> <strong>Safety &amp; Safeguards:</strong> Includes a dry-run mode (<code>--dry-run</code>) to preview changes, an interactive human-in-the-loop confirmation prompt, and an edge-case handler that gracefully detects when a folder is already organized.</li> <li> <strong>Audit Trail:</strong> Automatically records all moved items and errors into a persistent <code>file_butler.log</code> file.</li> </ul> <h2> Why Does Open Innovation Matter? </h2> <p>Leveraging open-weight models through high-performance cloud inference (Groq) allowed File Butler to process directory structures instantly without requiring a heavy local GPU or proprietary vendor lock-in. Furthermore, using a lightweight open-weight model keeps inference costs virtually zero, ensuring the utility runs comfortably within free developer tier limits while remaining fast and adaptable.</p> <h2> The Lazy Payoff </h2> <p>Instead of wasting mental energy and precious weekend time dragging hundreds of loose files into custom folders one-by-one, File Butler organizes an entire cluttered directory in a single keystroke. It turns a dreaded weekly chore into a one-second background task, letting you lean back, relax, and channel your inner sloth.</p> devchallenge hf26challenge