Uses an AI agent (powered by Google Gemini via the Agno framework) to intelligently propose and execute a plan for organizing files within a specified directory on your computer.

AI File Organizer Agent

This Python script uses an AI agent (powered by Google Gemini via the Agno framework) to intelligently propose and execute a plan for organizing files within a specified directory on your computer.

Features

• AI-Powered Planning: Leverages a Gemini language model to analyze the current file structure and suggest a logical organization plan.
• User Interaction: Presents the proposed plan for review, allowing the user to approve, reject, or provide feedback for revisions.
• Robust Filesystem Interaction: Uses the Model Context Protocol (MCP) and the standard @modelcontextprotocol/server-filesystem for safe and sandboxed file operations (listing directories, creating directories, moving files/folders).
• Configurable Target Directory: Allows setting a default directory or prompts the user, ensuring operations stay within a defined top-level boundary.
• Rate Limit Handling: Includes basic handling for API rate limits (429 errors) with an automatic pause.
• Debug Mode: Includes a DEBUG flag for more verbose output during execution.

Requirements

• Python 3.x
• Node.js and npx (comes with npm, usually installed with Node.js). Required to run the MCP filesystem server.
• Google API Key with Gemini API access. Get one from Google AI Studio.
• Required Python packages (see requirements.txt):
  • agno
  • mcp
  • google-genai
  • python-dotenv

Setup

1. Clone/Download: Get the file_organizer_agent.py, requirements.txt, and .env files.
2. Install Node.js: If you don't have it, download and install Node.js LTS from nodejs.org. This will include npm and npx.
3. Create Python Virtual Environment (Recommended):

   python3 -m venv .venv
   source .venv/bin/activate  # On Windows use `.venv\Scripts\activate`
   

4. Install Python Dependencies: