SlothSort: The 100% Offline AI File Organizer for Supreme Laziness 🦥

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.

What I Built Let's be completely honest: nobody enjoys organizing their Downloads or Inbox folder.

Every developer, student, and creator ends up with a chaotic dumping ground of files named receipt_oct.txt, script_dump (2).py, db_notes_final_v2.md, or invoice_9482.pdf. We tell ourselves we’ll organize them over the weekend, but we never do.

To honor the "Slow and Steady" Hacktoberfest challenge, I built SlothSort — an autonomous, 100% offline file-organization agent that does the thinking and filing for you, so you never have to lift a finger again.

Drop any messy file into the inbox/ directory (or let the background watcher monitor your downloads), and SlothSort:

Peeks inside the file: Extracts snippets from text files, scripts, or PDFs. Consults a local open-weight AI (llama3.2:3b): Understands the context and determines the ideal category (Invoices_and_Finance, Academics_and_Notes, Code_and_Dev, Identity_and_Docs, Media_and_Design, Misc). Smartly renames the file: Turns cryptic names like db_assignment_notes.md into descriptive, searchable snake_case names like cs_401_advanced_database_systems_assignment_3_notes.md. Files it away safely: Handles duplicate name collisions automatically.

Demo Here is SlothSort in action running a live batch sort on unorganized files: [🦥 SlothSort] Found 3 cluttered file(s) in 'inbox/'. Initiating batch sort...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ [🦥 SlothSort] Examining: db_assignment_notes.md ↳ Extraction: via text reader (.md) (833 chars) ↳ Classifying: with llama3.2:3b (100% offline)... ↳ Category: Academics_and_Notes ↳ Clean Name: cs_401_advanced_database_systems_assignment_3_notes.md ↳ Reason: File content snippet is related to academic notes and assignment analysis. ↳ Engine: Local Ollama (llama3.2:3b) ↳ Filed to: organized\Academics_and_Notes\cs_401_advanced_database_systems_assignment_3_notes.md

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ [🦥 SlothSort] Examining: receipt_oct.txt ↳ Extraction: via text reader (.txt) (610 chars) ↳ Classifying: with llama3.2:3b (100% offline)... ↳ Category: Invoices_and_Finance ↳ Clean Name: receipt_oct.txt ↳ Reason: File contains an invoice receipt. ↳ Engine: Local Ollama (llama3.2:3b) ↳ Filed to: organized\Invoices_and_Finance\receipt_oct_1.txt

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ [🦥 SlothSort] Examining: script_dump.py ↳ Extraction: via text reader (.py) (667 chars) ↳ Classifying: with llama3.2:3b (100% offline)... ↳ Category: Code_and_Dev ↳ Clean Name: bubble_sort_algorithm_demo.py ↳ Reason: File contains code snippet for a sorting algorithm. ↳ Engine: Local Ollama (llama3.2:3b) ↳ Filed to: organized\Code_and_Dev\bubble_sort_algorithm_demo.py

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ [🦥 SlothSort] Batch sorting complete! Successfully organized 3 file(s). Check your sorted files in: organized/

SlothSort also features a Live Watcher Daemon (python sloth_sort.py --watch) powered by watchdog that continuously runs in the background, filing files the second they land in your inbox.

Code The complete source code, tests, and documentation are open-sourced on GitHub:

Autonomous, 100% Offline Local File Organizer powered by Open-Weight AI ( llama3.2:3b via Ollama). Built for the Hacktoberfest "Slow and Steady" Challenge. 🌿

.---. _ ___ _ _ _ ___ _ / _ \ | | / __| |___ | |_| |_/ __| ___ _ _ _| |_ | / \ || |__ \__ \ / _ \| _| ' \__ \/ _ \ '_| _| | \_/ || '_ \ |___/_\___/ \__|_||_|___/\___/_| \__| \___/\_/|_.__/ 🦥 Zero effort file organization 🦥 💡 The Problem: Digital Hoarding & Cluttered Inboxes Every developer, student, and knowledge worker has a chaotic Downloads or Inbox folder filled with messy names like:

Manually inspecting, renaming, and filing them is tedious. SlothSort solves this by doing the work so you don't have to lift a finger. Just drop files into inbox/, and SlothSort…