I Built SlothSort AI: A Local-First File Organizer with AI-Powered Naming Suggestions 🦥

Description and use

A developer built SlothSort AI, a local‑first file organizer that uses a Gemma model via Ollama to suggest clearer filenames, allowing users to approve, apply, or undo renames.

Problem

Users struggle with unclear filenames and repetitive manual renaming.

Outcome

The project demonstrates how to integrate a local AI model into a Node.js app for filename suggestions, providing a user‑controlled workflow with undo capability and automated tests covering core functionality.

Workflow

• Scan the target folder
• Review file information (name, extension, size, date)
• Generate filename suggestions using a local Gemma model via Ollama
• Select desired rename suggestions
• Apply selected renames or undo the last batch

Evidence

SlothSort AI is a file organizer that uses a locally running AI model to suggest clearer, more consistent filenames.

Source

The user reviews the suggestions, selects the desired changes, and can undo the last rename operation.

Source

Use a local Gemma model through Ollama to suggest better filenames.

Source

The application works with filenames and file metadata; it doesn't need to read document contents to generate suggestions.

Source

All nine tests passed in my latest local run.

Source