AI-powered assistant to organize files on your computer.

It reads files in a directory and moves them to a new directory based on the file name, type and content. The destination directory is determined by the LLM model (supports GPT or Claude by Anthropic).

This project uses Poetry for Python dependency management and NPM for JavaScript dependency management. Please have them both installed before proceeding.

Install the dependencies:

poetry update && cd file_organizer_ui && npm install

You need your own API key to run this project. Copy .env.example to .env and fill in the values. At least one of the following is required:

• openai_api_key
• anthropic_api_key

First, start the backend server:

poetry run flask run

Then, start the UI:

cd file_organizer_ui && npm run dev

Visit http://localhost:3000/ to use the UI.