Nagaraj Nikhil RB

Posted on Oct 25

SlothSort — a zero-effort, autonomous desktop and downloads janitor that cleans up your digital clutter while you do absolutely nothing.

#devchallenge #hf26challenge

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

I built SlothSort 🦥 — a zero-effort, autonomous desktop and downloads janitor that cleans up your digital clutter while you do absolutely nothing.

What Effort Does It Save?

Admit it: your Downloads and Desktop folders are digital laundry chairs. Right now, you probably have a chaotic pile of:

Screenshot_2024-10-19_at_03.14.22_AM.png
INV_9921_october_stripe_final(1).pdf
docker-compose.prod.v2.backup.yml
Random health insurance tax forms, memes, installer .exes, and grocery notes.

Cleaning this mess manually requires relentless decision fatigue: What was this file? Where should it go? What should I rename it?

SlothSort channels the spirit of International Sloth Day:

It reads your messy files.
It uses local open-source AI to semantically deduce their true purpose (Receipts & Invoices, Work & Documents, Memes & Photos, Code & Configs, Installers & Archives).
It renames cryptic filenames into clean, standardized kebab-case (e.g., 2024-10-25-receipt-stripe-9921.pdf).
It moves them into tidy folders at a deliberate "sloth pace" so your laptop fan doesn't even spin up.

Who gets to be lazier? Every developer, student, and digital hoarder who would rather take a nap than spend Sunday afternoon dragging files into folders.

Demo

Here is SlothSort in action running in dry-run mode and through its local web dashboard:

=============================================================
  🦥  SLOTH-SORT: Slow and Steady Autonomous File Tidier  🦥
=============================================================
📂 Target Folder: /Downloads
⚙️  Mode:          LIVE (Moving & Renaming Files)
🧠 AI Engine:     Local Open-Weight Model (Llama 3.2 via Ollama)
-------------------------------------------------------------

🔍 Found 8 cluttered files. Proceeding at sloth pace...

 [1/8] 🦥 Processing: INV_9921_october_stripe_final(1).pdf
      📁 Destination: Receipts & Invoices/
      🏷️  Rename to:   2024-10-25-receipt-inv-9921-stripe.pdf
      💡 Reason:      Semantic match on tax & payment invoice
      ✅ Moved cleanly!

 [2/8] 🦥 Processing: Screenshot_2024-10-19_at_03.14.22_AM.png
      📁 Destination: Memes & Photos/
      🏷️  Rename to:   2024-10-25-screenshot-notes.png
      💡 Reason:      Semantic match on .png image
      ✅ Moved cleanly!

=============================================================
🎉 SLOTH REPORT: Tidy complete while you conserved energy!
📊 Total Files Handled:  8
🔋 Energy Conserved:      100%
😴 Human Effort Expended: 0%
=============================================================

You can also launch the cozy Sloth Dashboard (node server.js):

Interactive visual before-and-after bucket animations.
Slow & Steady Toggle: Keeps CPU throttle gentle to avoid thermal spikes.
Live Sloth audit log with energy conservation metrics.

Code

NICKSTER0506 / slothsort

🦥 SlothSort — Slow and Steady Autonomous File Tidier

"Channel your inner sloth. Let open-source AI clean your digital clutter while you conserve energy."

Built for International Sloth Day and the Dev.to Open-Source AI Challenge: Slow and Steady.

🌟 The Philosophy

Sloths are the zen masters of nature: they move at their own deliberate pace (0.15 mph), avoid unnecessary exertion, and conserve their precious energy.

Yet as developers and computer users, we constantly dread the chaotic mess in our Downloads and Desktop folders:

Screenshot_2024-10-19_at_03.14.22_AM.png
INV_9921_october_stripe_final(1).pdf
docker-compose.prod.v2.backup.yml
Random receipts, tax docs, memes, and executables piling up for months.

Organizing them manually requires mental energy we'd rather spend taking a nap.

SlothSort is an autonomous desktop janitor that runs quietly on your machine. Using local, open-source AI, it reads your files, semantically categorizes them into tidy folders, cleans up erratic filenames into clean kebab-case, and leaves a gentle report of the…

View on GitHub

Repository: https://github.com/NICKSTER0506/slothsort

Built with pure, zero-dependency Node.js (no heavy node_modules bloat or build steps required). Clone it and run it in 10 seconds:

# Clone the repository
git clone https://github.com/NICKSTER0506/slothsort.git
cd slothsort

# Run safe preview on the test messy folder
node slothsort.js test-messy-folder

# Or launch the local web UI
node server.js

How I Built It

SlothSort is designed around open-source AI and lightweight local execution:

Open-Weight Model Integration (Ollama): SlothSort connects natively to local open-weight models (llama3.2, qwen2.5, smollm2, or mistral) running on http://localhost:11434. It prompts the local model to analyze filenames and text previews, returning structured JSON categorization and clean file names.
Standalone Open Semantic Fallback: If Ollama is not active, SlothSort seamlessly falls back to an internal pattern and semantic categorization engine. Zero external setup is needed to test it out of the box.
The "Slow and Steady" Throttling Engine: Unlike traditional scripts that max out 100% of CPU cores, SlothSort introduces intentional pacing pauses (slowAndSteadyDelayMs). It does its chores in the background without causing laptop fans to roar or draining your battery.
Zero-Bloat Architecture: The web dashboard and API server run on Node's native http and fs modules with Tailwind CSS loaded via CDN—no multi-gigabyte build artifacts.

Why Does Open Innovation Matter?

For an automated file organizer, open-source AI isn't just an alternative—it is the only responsible architecture.

Absolute Privacy (Keeping Personal Data Off Remote Servers): Your Downloads folder holds the most private corners of your life: W-2 tax forms, bank receipts, passport scans, medical records, and proprietary work documents. Sending those file contents to proprietary closed-source cloud APIs (like OpenAI or Anthropic) means handing sensitive documents over to third-party servers. With local open-weight models, 100% of inference happens on your laptop. Zero bytes leave your machine.
Runs Everywhere With No Internet: Whether you're on a transcontinental flight in airplane mode or working in a remote cabin with no Wi-Fi, SlothSort runs unaffected. Closed APIs die the moment your connection drops.
$0 Cost & No Token Metering: Proprietary APIs charge per token and impose rate limits. Open-source models allow you to organize 10,000 files a day forever at zero cost.
Model Freedom: Open-source AI lets you swap models at will. Run ultra-lightweight SmolLM2 (1.7B) on an older ultrabook, or spin up Llama 3.2 (3B) or open multimodal vision models on modern silicon.

The Lazy Payoff

Time Saved: ~45 minutes of dread and manual file dragging every week.
Cognitive Energy Saved: 100%. No more staring at Screenshot_2024-10-19... wondering what it was.
Laptop Fan Noise: 0 dB (thanks to the sloth-pace throttle).
Guilt Removed: Zero digital clutter guilt while you sleep, watch movies, or take an afternoon nap.

Prize Categories

Slow and Steady (Week 3 Challenge Track): Built with open-source AI at its core, rewarding laziness, and honoring International Sloth Day!

DEV Community