I wanted a file management tool that actually understands what my files are about. Previous projects like LlamaFS (https://github.com/iyaja/llama-fs) aren't 100% local and require an AI API. So, I created a Python script that leverages AI to organize local files, running entirely on your device for complete privacy. It uses Google Gemma2 2B and llava-v1.6-vicuna-7b models for processing.
Note: You won't need any API key and internet connection to run this project, it runs models entirely on your device.
What it does:
- Scans a specified input directory for files
- Understands the content of your files (text, images, and more) to generate relevant descriptions, folder names, and filenames
- Organizes the files into a new directory structure based on the generated metadata
- Images: .png, .jpg, .jpeg, .gif, .bmp
- Text Files: .txt, .docx
- PDFs: .pdf
It's fully open source.
For demo & installation guide - GitHub: (https://github.com/QiuYannnn/Local-File-Organizer)
Shoutout to Nexa SDK (https://github.com/NexaAI/nexa-sdk). I discovered it on Reddit and it made this project possible by allowing LM and VLM running entirely on local devices.
What do you think about this project? Is there anything you would like to see in the future version?
Thank you!