Show HN: I built a Python script uses AI to organize files, runs 100% locally

[qiuyannn]

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

Supported file types:

  - Images: .png, .jpg, .jpeg, .gif, .bmp

  - Text Files: .txt, .docx

  - PDFs: .pdf

Supported systems: macOS, Linux, Windows

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!

[jen729w]

Hi, I’m Johnny.Decimal. I can’t find a contact for you on GitHub. Reach out if you want help with the JD part of your roadmap.

[QodeQode]

ePub format would make it interesting. Although calibre does a good job and alternative would be welcome

[qiuyannn]

Thanks for the input! I will definitely check on the support for ebook format. I think Gemma2 models read books pretty well now!