SlothClerk: A Local AI Agent for Organizing Cluttered Folders

Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady Submission 🦥

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady

Every developer's desktop and Downloads folder eventually turns into a chaotic swamp of forgotten files:

📄 IMG_9421_screenshot_receipt.png 📄 statement_final_v2(3).pdf 📄 chaotic_meeting_notes.md 📄 unorganized_dataset.csv 📄 untidy_tax_document.pdf Enter fullscreen mode Exit fullscreen mode We always tell ourselves: "I'll sit down and clean this up on Sunday." But Sunday comes, and instead of spending 45 minutes manually opening PDFs, squinting at receipts, renaming them, and clicking into nested directories, we'd rather take a nap.

In honor of International Sloth Day and this week's "Slow and Steady" theme, I built SlothClerk: a zero-telemetry, 100% offline background agent powered by local open-weight models (via Ollama, natively supporting llama3.2:3b, mistral, or qwen2.5:3b ).

.---. _____ _ _ _ _____ _ _ / \ / ___| | | | | | / __ \ | | | | () () | \ `--.| | ___ | |_| |__ | / \/ | ___ _ __| | \ - / `--. \ |/ _ \| __| '_ \| | | |/ _ \ '__| | ||||| /\__/ / | (_) | |_| | | | \__/\ | __/ | |_| ''''' \____/|_|\___/ \__|_| |_|\____/_|\___|_| (_) The AI file butler that does the chores while you snooze. Enter fullscreen mode Exit fullscreen mode Who gets to be lazier? Developers & Tech Workers: No more hunting for scripts, meeting notes, or raw datasets scattered across your home directory.

Freelancers & Solopreneurs: Invoices and expense receipts get sorted into clean, dated folders ( /Documents/Invoices/2026-10-invoice-internet-provider.pdf ) without typing a single character. Anyone Who Loves Peace of Mind: You never have to manually organize a file again. You drop files in, go take a nap, and wake up to a pristine digital sanctuary and a witty Sloth Morning Briefing.

Demo SlothClerk provides both a cozy, dark earthy Web Dashboard and a one-liner rich terminal CLI:

For power users who prefer the command line:

# Preview what SlothClerk wants to do without moving a single byte: python -m slothclerk tidy --dry-run Enter fullscreen mode Exit fullscreen mode SlothClerk Organization Plan (DRY-RUN) ┌────────────────┬─────────────────┬────────────────┬───────┬─────────────────┐ │ Original File │ Clean Filename │ Category │ Conf. │ Sloth Summary │ ├────────────────┼─────────────────┼────────────────┼───────┼─────────────────┤ │ 2026_internet… │ 2026-10-invoic… │ Documents/Inv… │ 78% │ Slowly dragged │ │ │ │ │ │ this invoice │ │ │ │ │ │ into the folder │ │ │ │ │ │ while eyeing a │ │ │ │ │ │ hammock. │ │ chaotic_meeti… │ 2026-10-notes-… │ Personal/Notes │ 78% │ Carefully │ │ │ │ │ │ folded these │ │ │ │ │ │ scattered notes.│ │ untidy_tax_do… │ 2026-10-tax-do… │ Documents/Tax… │ 78% │ Gently slipped │ │ │ │ │ │ this tax doc │ │ │ │ │ │ under leaves. │ └────────────────┴─────────────────┴────────────────┴───────┴─────────────────┘ [i] Dry-run mode completed. No files were moved or altered. To apply these changes, run: python -m slothclerk tidy --execute Enter fullscreen mode Exit fullscreen mode And your personalized morning digest:

python -m slothclerk briefing Enter fullscreen mode Exit fullscreen mode ┌────────────────────────── Sloth Morning Briefing ───────────────────────────┐ │ Morning Report: 6 Chores Finished Before You Woke Up │ │ │ │ While you were resting, 6 wandering files were slowly escorted into │ │ Documents/Invoices, Documents/Receipts, and Personal/Notes. │ │ Your desktop is tidy, no cloud servers were bothered, and your only │ │ remaining obligation is a warm cup of coffee. │ │ │ │ Mood: Horizontal and Victorious 🦥 | Date: Thursday, October 22, 2026 │ └─────────────────────────────────────────────────────────────────────────────┘ Enter fullscreen mode Exit fullscreen mode Code The full source code is licensed under MIT and open-sourced on GitHub:

"The AI file butler that does the chores while you snooze."

SlothClerk is a zero-telemetry, 100% offline background file organizer powered by local open-weight models (via Ollama, natively supporting llama3.2:3b, mistral:latest, or qwen2.5:3b ).

Modern digital work leaves desktops and download folders buried in messy names like IMG_9421_screenshot_receipt.png, statement_final_v2(3).pdf, or unorganized_dataset.csv. Manual cleanup is tedious, while sending personal tax forms, invoices, and contracts to cloud AI APIs compromises privacy and racks up subscription costs.