Skip to content

v1.0.0 — SlothSort: Autonomous Local AI File & Clutter Tidier

Latest
Latest

Choose a tag to compare

View all tags
@tharu200304 tharu200304 released this 22 Oct 03:48
· 11 commits to main since this release
v1.0.0
42ca8db

🦥 SlothSort v1.0.0 — Initial Release

We are excited to announce the first release of SlothSort, an autonomous, privacy-first local file and clutter organizer powered by open-weight models.

SlothSort watches your messy Downloads or Desktop folder, reads file contents safely using local quantized models, generates clean normalized filenames, and moves them into organized vaults—with 100% privacy, zero cloud egress, and 1-click reversible undo.

🌟 Key Features

  • 🖥️ Viewport-Fitted Web Dashboard: A single-page, dark glassmorphic interface engineered to fit your display (100vh) with zero outer scrollbar clutter.
  • ⚡ Dense & Sleek File Tiles: Compact ~38px file cards displaying categories, date-stamped names, file size, AI intent snippets, and quick action buttons.
  • 📂 Universal PC Folder Support: Tidy Downloads, Desktop, Documents, or any custom path on Windows, macOS, or Linux.
  • 🧠 Dual-Engine Architecture: Powered by local open-weight SLMs (Llama 3.2 3B, Qwen 2.5 3B, Phi-3.5 Mini, Mistral 7B via Ollama) with instant automatic fallback to high-accuracy deterministic offline heuristics.
  • 🛡️ Safe 2KB Header Sniffing: Inspects only file headers and text previews so multi-gigabyte files or video archives never freeze system memory.
  • ↩️ 1-Click Complete Reversibility: Every move is recorded in an append-only audit manifest (slothsort_manifest.jsonl) enabling instant, safe undo.
  • 📦 Batch Vault Management: Multi-select files to move across categories, bulk-delete, or download together as a single ZIP archive.
  • 👁️ In-App Previewer: Modal preview for images, rendered Markdown, syntax-highlighted code, and document snippets.
  • 🗂️ 18 Built-in Semantic Domains: Invoices, Banking, Spreadsheets, Legal, Research, Code, Notes, Health, Media, Presentations, E-Books, Travel, Resumes, Configs, Archives, Audio, Work, and Miscellaneous.

🚀 Quickstart

# Clone the repository
git clone https://github.com/tharu200304/SlothSort.git
cd SlothSort

# Install lightweight dependencies
pip install -r requirements.txt

# Launch the Web Dashboard
python app.py
Assets 2
Loading