I built a sloth-brained Downloads folder tidier that runs 100% offline

说明与用途

一款完全离线的本地 LLM 工具，自动对下载文件进行分类、重命名并移动到结构化文件夹，消除手动清理的麻烦。

问题

The Downloads folder becomes cluttered with unnamed or poorly named files, making organization a tedious chore.

结果

The tool runs fully offline, automatically categorizes and renames files, and logs moves for undo, eliminating manual cleanup.

工作流

• Install Ollama and pull a model (e.g., qwen2.5:7b).
• Install Python 3.11+ (no pip packages needed).
• Edit config.toml to set folders, model, and categories.
• Run python tidier.py run for a dry run.
• Run python tidier.py run --apply to execute moves.
• Run python tidier.py watch --apply to keep the script running and tidy new downloads.
• Use python tidier.py undo to reverse the last batch.

证据

lazy-downloads-tidier watches the folder, reads each file, and asks a local LLM two questions: which of my categories does this belong in? and what should it be called?

来源

Install Ollama and pull a model
ollama pull qwen2.5:7b # or gemma3:4b / llama3.2:3b for less RAM

来源

Dry run by default. You must pass --apply to move anything.

来源

The tool reads my tax PDFs, contracts, and personal photos. Sending those to someone else's API to get a better filename isn't a trade I'd make. With a local model, the files never leave the disk.

来源