This is a submission for the Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady
🦥 SlothDesk: Let AI Organize Your Files While You Do Absolutely Nothing
What if your computer could clean up your messy folders without sending your personal file metadata to a cloud AI service?
We all have that one folder. Hundreds of screenshots, PDFs with meaningless names, documents we promised to organize later, and duplicate files we are afraid to delete.
I built SlothDesk, a local-first AI file organizer powered by Qwen, to make that repetitive work a little less painful.
The idea behind this project is simple: let AI do the tedious thinking, keep humans in control, and make getting organized effortless.
What I Built
SlothDesk is a local AI-powered file organization assistant that scans a selected folder, proposes a cleaner structure, and lets users review changes before applying them.
Instead of manually inspecting and renaming every file, you can let SlothDesk prepare an organization plan.
Here's what it does:
- AI-powered organization: Suggests categories and more readable filenames using a locally running Qwen model.
- Human-in-the-loop automation: Review, edit, approve, or reject suggestions before anything changes.
- Exact duplicate detection: Identifies files with identical content using SHA-256 hashes.
- Safety checks: Validates filenames and destinations and prevents silent overwrites.
- Undo support: Records successful operations so supported changes can be reversed.
- Local-first processing: Uses Ollama for local model inference instead of requiring a hosted AI API for the core workflow.
The target user is anyone who spends too much time organizing downloads, project documents, study materials, screenshots, or other digital clutter.
The goal isn't to build an AI that takes over your computer. It's to build one that handles the boring stuff while you stay in control.
Demo
Try it locally: Follow the setup instructions in the repository's README.
Code
GitHub repository: [https://github.com/pixelcrisscross/SlothDesk.git]
The project is written in Python and uses Streamlit for its interface.
The codebase separates the AI planner from the filesystem execution layer. This means model suggestions are treated as untrusted input and validated before any approved operation is executed.
The repository includes the application, setup instructions, safety checks, undo functionality, and automated tests.
How I Built It
I built SlothDesk using a deliberately lightweight stack:
- Python — application logic and filesystem operations.
- Streamlit — a browser-based local interface.
- Ollama — local model inference.
- Qwen — open-weight AI for generating organization suggestions.
- Pydantic — structured output validation.
- SQLite — local operation history.
- SHA-256 — exact duplicate detection.
- pytest — automated tests for important safety and rollback behavior.
The workflow has four main stages.
1. Scan: The application collects basic file metadata, including filenames, extensions, and sizes.
2. Plan: Qwen generates structured suggestions for filenames and destination categories. In this MVP, the model does not inspect document contents.
3. Validate: The application checks the suggestions, rejects unsafe paths, and detects destination conflicts.
4. Execute: Only explicitly approved changes are applied, and successful operations are recorded for potential rollback.
One important design choice was to keep model reasoning separate from file operations. The model does not generate shell commands or directly execute arbitrary instructions against the filesystem.
The application, rather than the model, controls what operations are permitted.
Why Does Open Innovation Matter?
For SlothDesk, open innovation is about more than avoiding an API bill. It gives developers greater control over where inference happens, how models are selected, and how an application behaves.
1. Privacy by design
Filenames can reveal project names, personal details, and other sensitive information.
By using local inference, SlothDesk can process file metadata without sending it to a hosted AI model API. This reduces external data exposure, although local execution alone does not guarantee complete security or privacy.
2. Less dependence on paid APIs
Once the model is downloaded, inference can run locally without a per-request fee from a hosted AI provider. Hardware, electricity, storage, and setup still have costs, but the core workflow doesn't depend on a paid inference endpoint.
3. Freedom to experiment
Starting with Qwen lets me explore different model sizes and configurations based on the laptop's available resources.
The model layer is separate from the file-operation logic, making it easier to experiment without rewriting the safety system.
4. More control over automation
A closed API can provide excellent model capabilities, but SlothDesk's core value comes from combining AI suggestions with locally enforced rules.
The application can validate destinations, require approval, record changes, and support rollback regardless of which compatible model generates the suggestions.
Open innovation makes it possible to build an assistant around the principle that your files should remain under your control, even when AI helps organize them.
The Lazy Payoff
The payoff is fewer repetitive decisions.
Instead of manually reviewing every filename and deciding where each file belongs, users can review a batch of AI-generated suggestions in one place.
I haven't established a reliable time-saving benchmark yet, so I won't claim a specific percentage improvement. A useful next experiment would compare manual organization against SlothDesk using the same synthetic folder, measuring completion time, classification accuracy, and the number of corrections required.
The goal is to make one of those small, annoying tasks disappear from the to-do list.
Less sorting. Fewer repetitive decisions. More time for something else.
Prize Categories
Primary target: Overall Hacktoberfest Open-Source AI Challenge Week 3 prize.
SlothDesk is built around local open-weight AI and directly addresses the Slow and Steady theme through practical automation.
I'm not claiming any partner-specific prize category at this stage. I would only add a partner category if the finished implementation genuinely uses the required partner technology.
SlothDesk is my attempt to make AI useful in a quieter way.
Not another assistant demanding more of your attention, but one that helps you get a tedious task out of the way.
Because sometimes the most productive thing you can do is let your computer do the organizing.
🦥 Stay slow. Stay organized. Let AI handle the boring stuff.
Top comments (0)