{"slug": "slothsort-ai-let-gemma-clean-your-messy-files-so-you-don-t-have-to", "title": "SlothSort AI: Let Gemma Clean Your Messy Files So You Don't Have To", "summary": "A developer built SlothSort AI, a local-first file organizer that uses Google's Gemma model run through Ollama to generate a structured JSON plan for sorting a messy folder, which users review and confirm before any files move. The FastAPI backend reads only file metadata—filenames, extensions, sizes and modification times—never file contents, and validates the model's output with Pydantic while keeping destinations inside the selected root folder and avoiding overwrites or deletions. The project is open source on GitHub and was submitted to the Hacktoberfest Open-Source AI Challenge.", "body_md": "*This is a submission for the Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady.*\n\nSlothSort AI is a local-first AI file organizer that turns the repetitive job of cleaning up a messy folder into a simple review-and-apply workflow.\n\nInstead of manually sorting files one by one, SlothSort lets local Gemma generate an organization plan that the user can review before anything changes.\n\nThe workflow is:\n\nSlothSort does not read file contents. It uses metadata such as filenames, extensions, file sizes, and modification times to create the organization plan.\n\n[Watch the full SlothSort AI demo](https://drive.google.com/file/d/13X1HWn7zbp1en4gDqcEbAZfpJyRiqz6b/view?usp=sharing)\n\nThe demo shows the complete workflow from creating a fake folder and scanning its files to generating, reviewing, and applying the AI organization plan.\n\n[View the SlothSort AI source code on GitHub](https://github.com/MANAV-MISHRA-BYTES/slothsort-ai)\n\nSlothSort AI is built with:\n\nThe architecture is intentionally lightweight:\n\n```\nUser\n  ↓\nSlothSort UI\n  ↓\nFastAPI\n  ↓\nOllama\n  ↓\nGemma 4 E4B\n  ↓\nStructured JSON plan\n  ↓\nPydantic validation\n  ↓\nReview\n  ↓\nUser confirmation\n  ↓\nFilesystem changes\n```\n\nThe backend scans the selected folder and collects metadata from visible files. That metadata is sent to Gemma through Ollama running locally.\n\nGemma returns a structured organization plan, which is validated with Pydantic before being presented to the user.\n\nNothing is changed during scanning or planning. Files are only moved after the user reviews the proposed changes and explicitly confirms the operation.\n\nThe backend also rechecks the scan before applying changes, keeps destinations inside the selected root folder, avoids intentional overwrites, and never deletes files.\n\nSlothSort uses Gemma locally through Ollama instead of depending on a proprietary hosted AI API.\n\nThis means the application can perform its AI planning locally without requiring a cloud AI account or API key. File contents are never read, and only file metadata required for organization is provided to the local model.\n\nOpen-weight models make this kind of local-first application possible while giving developers and users more control over the AI component and where their data is processed.\n\nOrganizing a messy folder is exactly the kind of repetitive task that is easy to keep postponing.\n\nSlothSort turns:\n\n```\nLook at file → Decide → Rename → Move → Repeat\n```\n\ninto:\n\n```\nSelect folder → Scan → Review AI plan → Confirm\n```\n\nThe goal is simple: let local AI handle the repetitive first pass while keeping the user in control of the final changes.\n\nAI coding tools were used during implementation, debugging, and refinement of the project.\n\nThe project concept, product direction, feature decisions, testing, final review, and submission were human-led.\n\nSolo submission.", "url": "https://wpnews.pro/news/slothsort-ai-let-gemma-clean-your-messy-files-so-you-don-t-have-to", "canonical_source": "https://dev.to/manav_mishra_108/slothsort-ai-let-gemma-clean-your-messy-files-so-you-dont-have-to-16oh", "published_at": "2026-10-25 15:41:28+00:00", "updated_at": "2026-10-25 15:43:13.475430+00:00", "lang": "en", "topics": ["ai-tools", "large-language-models", "ai-products", "developer-tools"], "entities": ["SlothSort AI", "Gemma", "Ollama", "FastAPI", "Pydantic", "GitHub", "Hacktoberfest"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/slothsort-ai-let-gemma-clean-your-messy-files-so-you-don-t-have-to", "markdown": "https://wpnews.pro/news/slothsort-ai-let-gemma-clean-your-messy-files-so-you-don-t-have-to.md", "text": "https://wpnews.pro/news/slothsort-ai-let-gemma-clean-your-messy-files-so-you-don-t-have-to.txt", "jsonld": "https://wpnews.pro/news/slothsort-ai-let-gemma-clean-your-messy-files-so-you-don-t-have-to.jsonld"}}