# README for PCSorter
## Introduction
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.
## Requirements
- Python 3.6 or higher
- `openai` Python package
- Additional Python libraries: `os`, `re`, `shutil`, `time`, `argparse`, `datetime`, `json`, `sys`
- An active OpenAI API key
## Installation Instructions
1. Ensure Python 3.6+ is installed on your system.
2. Install OrganizerPro via pip
```
pip install OrganizerPro
```
5. Set up an environment variable for your OpenAI API key (instructions in the next section).
### Setting Up Environment Variables
#### Windows
1. **Command Prompt:**
- Use `setx 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 named `OPENAI_API_KEY` with your API key as its value.
#### macOS
1. **Using Terminal:**
- Add `export 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.
#### Linux
1. **Using Terminal:**
- Similar to macOS, use `export 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.
## Configuration
Before running PCSorter, ensure the `OPENAI_API_KEY` environment variable is set.
## Usage Instructions
1. **Running the script:**
- Execute `organizerpro` 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: `organizerpro sort --dir ./my_directory`
- Using a specific GPT model: `organizerpro sort --model gpt-3.5-turbo`
## Troubleshooting
- **API Key Not Recognized:** Ensure the environment variable `OPENAI_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.
## FAQs
- **Can PCSorter handle large directories?**
Yes, but performance may vary based on the number and size of files.
## Contributing
Contributions to PCSorter are welcome. Please submit issues and pull requests through GitHub, adhering to the project's coding standards and guidelines.
## License
PCSorter is released under the MIT License. See the LICENSE file for more details.
## Acknowledgments
Thanks to the contributors and to OpenAI for the API that powers this project. Special thanks to [list any special contributors or resources].
Raw data
{
"_id": null,
"home_page": "https://github.com/chroakPRO/Desktop-Cleaner/tree/ai-integration",
"name": "OrganizerPro",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "ai organizer",
"author": "Christopher EK",
"author_email": "chr.oak@icloud.com",
"download_url": "https://files.pythonhosted.org/packages/a8/af/6fcbec04dd15ca5e13106a7419122d74ec006aea9c8c328ea3411d6c6fa2/OrganizerPro-0.1.1.tar.gz",
"platform": null,
"description": "# README for PCSorter\r\n\r\n## Introduction\r\n\r\nPCSorter 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.\r\n\r\nKey Features:\r\n- File sorting using AI-driven insights.\r\n- Customizable directory and file type handling.\r\n- Backup and restore functionality for sorted files.\r\n- Cross-platform compatibility with detailed setup instructions.\r\n\r\n## Requirements\r\n\r\n- Python 3.6 or higher\r\n- `openai` Python package\r\n- Additional Python libraries: `os`, `re`, `shutil`, `time`, `argparse`, `datetime`, `json`, `sys`\r\n- An active OpenAI API key\r\n\r\n## Installation Instructions\r\n\r\n1. Ensure Python 3.6+ is installed on your system.\r\n2. Install OrganizerPro via pip\r\n ```\r\n pip install OrganizerPro\r\n ```\r\n5. Set up an environment variable for your OpenAI API key (instructions in the next section).\r\n\r\n### Setting Up Environment Variables\r\n\r\n#### Windows\r\n\r\n1. **Command Prompt:**\r\n - Use `setx OPENAI_API_KEY \"Your-API-Key\"` to set the API key.\r\n2. **PowerShell:**\r\n - Apply `$env:OPENAI_API_KEY = \"Your-API-Key\"` to set the key.\r\n3. **Editing System Properties:**\r\n - Open System Properties -> Advanced -> Environment Variables.\r\n - Add a new System variable named `OPENAI_API_KEY` with your API key as its value.\r\n\r\n#### macOS\r\n\r\n1. **Using Terminal:**\r\n - Add `export OPENAI_API_KEY=\"Your-API-Key\"` to your `.bash_profile` or `.zshrc`.\r\n2. **Editing `.bash_profile` or `.zshrc`:**\r\n - Open these files in a text editor and add the export line as above.\r\n\r\n#### Linux\r\n\r\n1. **Using Terminal:**\r\n - Similar to macOS, use `export OPENAI_API_KEY=\"Your-API-Key\"` in `.bashrc` or equivalent.\r\n2. **Editing `.bashrc` or equivalent:**\r\n - Open the file in an editor and add the export command.\r\n\r\n## Configuration\r\n\r\nBefore running PCSorter, ensure the `OPENAI_API_KEY` environment variable is set.\r\n\r\n## Usage Instructions\r\n\r\n1. **Running the script:**\r\n - Execute `organizerpro` in your terminal.\r\n - Use command-line arguments to specify options like `--model`, `--dir`, `--include`, `--backup`.\r\n2. **Common use cases:**\r\n - Sorting files in the current directory: `organizerpro sort --dir ./my_directory`\r\n - Using a specific GPT model: `organizerpro sort --model gpt-3.5-turbo`\r\n\r\n## Troubleshooting\r\n\r\n- **API Key Not Recognized:** Ensure the environment variable `OPENAI_API_KEY` is correctly set.\r\n- **Permission Errors:** Run the script with appropriate permissions or from a non-restricted directory.\r\n- **Invalid Model Specified:** Check that the model name is correct and supported.\r\n\r\n## FAQs\r\n\r\n- **Can PCSorter handle large directories?**\r\n Yes, but performance may vary based on the number and size of files.\r\n\r\n## Contributing\r\n\r\nContributions to PCSorter are welcome. Please submit issues and pull requests through GitHub, adhering to the project's coding standards and guidelines.\r\n\r\n## License\r\n\r\nPCSorter is released under the MIT License. See the LICENSE file for more details.\r\n\r\n## Acknowledgments\r\n\r\nThanks to the contributors and to OpenAI for the API that powers this project. Special thanks to [list any special contributors or resources].\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "OrganizerPro is a Python-based utility designed to intelligently organize files using the OpenAI ChatGPT API.",
"version": "0.1.1",
"project_urls": {
"Download": "https://github.com/chroakPRO/Desktop-Cleaner/archive/refs/heads/ai-integration.zip",
"Homepage": "https://github.com/chroakPRO/Desktop-Cleaner/tree/ai-integration"
},
"split_keywords": [
"ai",
"organizer"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3b25cdac6cf6cd56865949c540bc913f6d299945cd467c0f55f9a114f1e880c5",
"md5": "64584bbffd8c2642f37db4b33bbbf4b9",
"sha256": "167eab3faa29821f4e2f5f9648ab2467a19ddc948212520668a708551eaf3bcf"
},
"downloads": -1,
"filename": "OrganizerPro-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "64584bbffd8c2642f37db4b33bbbf4b9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 8898,
"upload_time": "2024-01-22T14:42:23",
"upload_time_iso_8601": "2024-01-22T14:42:23.175834Z",
"url": "https://files.pythonhosted.org/packages/3b/25/cdac6cf6cd56865949c540bc913f6d299945cd467c0f55f9a114f1e880c5/OrganizerPro-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a8af6fcbec04dd15ca5e13106a7419122d74ec006aea9c8c328ea3411d6c6fa2",
"md5": "47a2d51f43e970613c9ee164d091c33b",
"sha256": "3f10f062631cdd485391f5818b360710f92a26fd535b0abb5d028d4ac841d17a"
},
"downloads": -1,
"filename": "OrganizerPro-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "47a2d51f43e970613c9ee164d091c33b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 8642,
"upload_time": "2024-01-22T14:42:24",
"upload_time_iso_8601": "2024-01-22T14:42:24.313121Z",
"url": "https://files.pythonhosted.org/packages/a8/af/6fcbec04dd15ca5e13106a7419122d74ec006aea9c8c328ea3411d6c6fa2/OrganizerPro-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-22 14:42:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "chroakPRO",
"github_project": "Desktop-Cleaner",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "organizerpro"
}
JSON
