Sloth Sorter: an offline, low-RAM file tidier with undo

Description and use

Sloth Sorter is an offline file organizer for low-end laptops, using static embeddings and safe undo.

Problem

Users with low-end laptops need a safe, offline tool to organize messy Downloads folders without heavy ML or cloud dependencies.

Outcome

On a real Downloads folder of 503 files, a dry-run produced a full plan in seconds, sorting 431 files by rules and 72 by embeddings; the tool runs offline with ~303 MB footprint and 191 MB peak RAM.

Workflow

• Run sloth-sorter with default dry-run to preview actions
• Review the generated CSV report
• Execute with --apply to move and rename files
• Use --undo to revert changes if needed

Evidence

It sorts files into folders, optionally reads their contents to guess a better category, and can rename them.

Source

Dry-Run by Default. Nothing moves without explicit --apply.

Source

Safe Undo with SHA-256: SQLite-backed batch log tracks moves and renames, verifies hashes before reverting, and prevents overwriting conflicts.

Source

Benchmark on 30 synthetic documents: about 18 files/s, 191 MB peak RAM, 5 s model load (it includes the first-time download), 100% accuracy.

Source