Repository files navigation

PCSorter is a Python-based utility designed to intelligently organize files in a directory using the OpenAI ChatGPT API. This tool scans a specified directory (including subdirectories if desired), classifies files based on content and type, and reorganizes them into a more structured format. It leverages the advanced capabilities of OpenAI's GPT models to understand and categorize file contents, making file management more efficient and intuitive.

Key Features:

• File sorting using AI-driven insights.
• Customizable directory and file type handling.
• Backup and restore functionality for sorted files.
• Cross-platform compatibility with detailed setup instructions.

• Python 3.6 or higher
• openai Python package
• Additional Python libraries:os,re,shutil,time,argparse,datetime,json,sys
• An active OpenAI API key

1. Ensure Python 3.6+ is installed on your system.
2. Install AiSort via pip

   pip install aisort

3. Set up an environment variable for your OpenAI API key (instructions in the next section).

1. Command Prompt:
   • Usesetx OPENAI_API_KEY "Your-API-Key" to set the API key.
2. PowerShell:
   • Apply$env:OPENAI_API_KEY = "Your-API-Key" to set the key.
3. Editing System Properties:
   • Open System Properties -> Advanced -> Environment Variables.
   • Add a new System variable namedOPENAI_API_KEY with your API key as its value.

1. Using Terminal:
   • Addexport OPENAI_API_KEY="Your-API-Key" to your.bash_profile or.zshrc.
2. Editing.bash_profile or.zshrc:
   • Open these files in a text editor and add the export line as above.

1. Using Terminal:
   • Similar to macOS, useexport OPENAI_API_KEY="Your-API-Key" in.bashrc or equivalent.
2. Editing.bashrc or equivalent:
   • Open the file in an editor and add the export command.

Before running PCSorter, ensure theOPENAI_API_KEY environment variable is set.

1. Running the script:
   • ExecuteAiSort in your terminal.
   • Use command-line arguments to specify options like--model,--dir,--include,--backup.
2. Common use cases:
   • Sorting files in the current directory:AiSort sort --dir ./my_directory
   • Using a specific GPT model:AiSort sort --model gpt-3.5-turbo

• API Key Not Recognized: Ensure the environment variableOPENAI_API_KEY is correctly set.
• Permission Errors: Run the script with appropriate permissions or from a non-restricted directory.
• Invalid Model Specified: Check that the model name is correct and supported.

• Can PCSorter handle large directories?Yes, but performance may vary based on the number and size of files.

Contributions to PCSorter are welcome. Please submit issues and pull requests through GitHub, adhering to the project's coding standards and guidelines.

PCSorter is released under the MIT License. See the LICENSE file for more details.

Thanks to the contributors and to OpenAI for the API that powers this project. Special thanks to [list any special contributors or resources].