ramu

Your Downloads folder, finally organized. With AI.

click to copy curl -fsSL https://raw.githubusercontent.com/imkuldeepahlawat/ramu/main/install.sh | bash

Single shell script. Open source. macOS + Linux.
View on GitHub

What it does

🗂

39 Smart Folders

PDFs sorted by type (bank statements, receipts, resumes). Images by format. Archives by source. Config files, code, media — everything has a home.

Full Undo

Every move logged in SQLite. Undo any of the last 4 sessions independently. One command to bring everything back.

🤖

AI Powered

Ollama runs locally on your machine. AI rescues misplaced files, understands natural language queries, generates file descriptions.

Runs Daily

Sets up a 9am cron job automatically. Wake up to a clean Downloads. Every day. Zero effort.

Where stuff goes

Downloads/
├── 01 PDFs/
│   ├── Statements & Bank/
│   ├── Receipts & Invoices/
│   ├── Resumes & CVs/
│   └── 5 more sub-folders...
├── 07 Images/ PNG/ JPEG/ Vectors/ Web/ Animated/
├── 09 Videos/ Screen Recordings/ MOV/ MP4/ MKV/
├── 10 Audio/ MP3/ WAV/ AAC/ FLAC/
├── 15 3D Models & CAD/
├── 17 Backend & Systems/ .py .go .rs .java
├── 19 Config & Infra/ Docker/ Kubernetes/ Secrets/
├── 21 Archives/ WhatsApp/ iOS/ Google Drive/
├── 25 ML & AI Models/ .onnx .safetensors .gguf
├── ... 27 more folders
└── 39 Other/ everything else

Commands

ramu organize ~/Downloads
ramu undo reverse the last session
ramu history see last 4 runs
ramu help full menu with all 39 folders
AI Features

Local AI, no cloud

ramu ai-sort suggest better folders for misplaced files
ramu ai-sort --apply move them (with full undo)
ramu ask "where's my resume" natural language file search
ramu describe AI-generated file descriptions
ramu ai-start start Ollama via Docker (no install needed)
Runs on your machine via Ollama (mistral 7B). No API keys. No data leaves your laptop. Works offline for known file types.