SlothTidy: A Zero-Friction, 100% Local AI File Daemon That Organizes Your Downloads While You Rest 馃Ε
This is a submission for the Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady What I Built A three-toed sloth moves at 0.24 km/h and survives on roughly 110 kilocalories a day because it refuses to waste metabolic energy on unnecessary movement. Humans, on the other hand, waste hours
This is a submission for the Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady
A three-toed sloth moves at 0.24 km/h and survives on roughly 110 kilocalories a day because it refuses to waste metabolic energy on unnecessary movement. Humans, on the other hand, waste hours every month manually opening scan_0042 (1).pdf, figuring out what it is, renaming it, creating a folder, and dragging it out of ~/Downloads.
SlothTidy is a zero-friction, privacy-first local file organization daemon built for developers, students, and digital hoarders who want a spotless filesystem while putting in zero manual effort.
Running quietly in the background (or on-demand via a single CLI command), SlothTidy watches ~/Downloads and ~/Desktop, inspects incoming files the moment they finish downloading, reads their contents locally, and uses a lightweight open-weight LLM ( qwen2.5:1.5b or llama3.2:1b ) to:
Students drowning in lecture PDFs, developers downloading tarballs and config scripts, and anyone tired of hunting for tax receipts or screenshots gets to embrace pure sloth energy.
One-Shot Scan ( sloth-tidy scan ~/Downloads ) Inspects a directory, extracts context from PDFs, source code, archives, and screenshots, classifies them via your local Ollama instance, and moves them into ~/Documents/Organized (or previews the table safely with --dry-run ).
Background Daemon ( sloth-tidy run ) Starts a non-blocking watchdog observer over ~/Downloads and ~/Desktop. Browser partial downloads (.crdownload,.part,.tmp,.aria2 ) are ignored automatically, and a POSIX file-lock + byte-size stability debouncer waits until large downloads finish writing before triggering inference.
Instant Rollback ( sloth-tidy undo [N] ) Never overwrites existing files (automatically resolves collisions as -1, -2 while preserving compound extensions like.tar.gz ), routes low-confidence files to Misc/Low_Confidence_Review, and reverses your last N moves with a single command.
The Sloth Energy Report Card ( sloth-tidy report ) Prints a terminal dashboard calculating total files sorted, megabytes organized, manual toil minutes saved, mental decisions avoided, and cloud API dollars saved.
`""==,,__ `"==..__"=..__ _ _..-==""_.-,`"=/ /\ \""/_)==""`` ( ( | | | \/ | \ '. | \; \ / | \ | | ||,-._.' |_| | ||.\_/\ -'; Y | ` | / |-. '. __/_ _.-' /' `'-.._____.-' 馃Ε SlothTidy Zero-friction, privacy-first local AI file organization daemon. Built for the Hacktoberfest 2026 "Slow and Steady" Challenge.
Sloths survive by conserving energy. You shouldn't spend yours manually renaming scan_0042 (1).pdf or dragging screenshots out of ~/Downloads.
SlothTidy runs quietly in the background, watches your ~/Downloads and ~/Desktop folders, extracts lightweight context once downloads finish writing, and uses a small open-weight language model ( qwen2.5:1.5b or llama3.2:1b ) running 100% locally on your CPU to categorize, rename ( YYYY-MM-DD-descriptive-slug.ext ), and file everything into ~/Documents/Organized.