How mauryasagar/ai-file-organizer works
Organizr is a local-first file organizer: users choose a folder, scan eligible files, review content-based category suggestions, and explicitly apply moves; they can undo the last move. The main flow and safety/history behavior are visible in app.py and organizer.py; the README documents additional formats, editable categories, previews, and run history. Relationships shown below are supported by excerpts or README statements; no other source was inspected.
Main entry points: app.py Streamlit workflow · organizer.py Apply and undo moves · classifier.py Local classification · scanner.py Safe file scan
Components 12
User interface
- Streamlit workflow
app.py - Editable plan and preview
app.py - Run history
app.py
File analysis
- Category settings
categories.json - Safe file scan
scanner.py - Text extraction
extractor.py - Local classification
classifier.py
File operations
- Apply and undo moves
organizer.py - Undo log
organizer.py
Other components
- User
- Ollama / Gemma
- Chosen folder
Connections 20
- User → Streamlit workflow: selects folder
README.md - Streamlit workflow → Safe file scan: scans folder
app.py - Safe file scan → Chosen folder: lists files
README.md - Streamlit workflow → Text extraction: extracts text
app.py - Text extraction → Chosen folder: reads content
README.md - Streamlit workflow → Local classification: classifies files
app.py - Streamlit workflow → Category settings: loads categories
- Local classification → Ollama / Gemma: requests category
classifier.py - Ollama / Gemma → Local classification: returns reason
classifier.py - Streamlit workflow → Editable plan and preview: builds plan
app.py - User → Editable plan and preview: reviews and edits
README.md - User → Streamlit workflow: approves moves
README.md - Streamlit workflow → Apply and undo moves: applies plan
app.py - Apply and undo moves → Chosen folder: moves files
organizer.py - Apply and undo moves → Undo log: writes moves
organizer.py - User → Streamlit workflow: requests undo
app.py - Streamlit workflow → Apply and undo moves: calls undo
app.py - Apply and undo moves → Undo log: reads moves
organizer.py - Apply and undo moves → Chosen folder: restores files
organizer.py - Streamlit workflow → Run history: records run
app.py