# ScriptedSketches
ScriptedSketches is an innovative Python package that brings the power of OpenAI's GPT-4 directly to your terminal, allowing you to generate ASCII art from textual descriptions. Designed with simplicity and ease of use in mind, ScriptedSketches opens up a world of creative possibilities for both developers and artists alike.
## Features
- **Ease of Use**: Generate art directly from the command line.
- **Powered by GPT-4**: Leverages the latest in AI technology for detailed and accurate art.
- **Custom Artwork**: Transforms your descriptions into unique ASCII art.
- **On-the-Fly Creation**: Instantly renders artwork in the terminal window.
## Installation
To get started with ScriptedSketches, install the package using pip:
```bash
pip install scriptedsketches
```
This command will download and install ScriptedSketches along with its dependencies. Ensure you have Python 3.6 or newer, as this is required for the package to function correctly.
## Configuration
Before using ScriptedSketches, you must obtain an API key from OpenAI and set it as an environment variable on your system. This key enables the package to communicate with OpenAI's API to generate ASCII art scripts.
### Setting Up the OPENAI_API_KEY
**For Linux and macOS Users:**
Open your terminal.
Run the following command:
```
export OPENAI_API_KEY='your_openai_api_key_here'
```
To make this change permanent, add the export command to your shell's startup script, such as ~/.bashrc, ~/.zshrc, or ~/.profile.
**For Windows Users:**
Open Command Prompt.
Run the following command:
```
setx OPENAI_API_KEY "your_openai_api_key_here"
```
Restart Command Prompt to apply the changes.
**Important**: Keep your API key secure and never commit it in your version-controlled files.
## Usage
Once installed and configured, generate ASCII art by simply typing:
```
scriptedsketches "describe your image here"
```
The terminal will display the ASCII art generated based on your description.
## How It Works
When you run the scriptedsketches command, the package communicates with the OpenAI API, sending your descriptive prompt to be processed by the GPT-4 model. The model then returns a Python script tailored to your description, which is executed locally to render your ASCII art in the terminal.
## Contributing
We welcome contributions to ScriptedSketches! If you have suggestions for improvements or encounter any issues, please feel free to open an issue or submit a pull request.
- Fork the Project
- Create your Feature Branch (git checkout -b feature/AmazingFeature)
- Commit your Changes (git commit -m 'Add some AmazingFeature')
- Push to the Branch (git push origin feature/AmazingFeature)
- Open a Pull Request
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Acknowledgments
- Thanks to OpenAI for providing the GPT-4 API.
- Hat tip to all contributors who have helped shape this project.
## Questions or Feedback
For any questions or feedback, please contact the project maintainer at jacobglapkin@gmail.com. Your input is valuable to us!
Raw data
{
"_id": null,
"home_page": "https://github.com/yourusername/scriptedsketches",
"name": "scriptedsketches",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "terminal art gpt-4-turbo",
"author": "Jacob Lapkin",
"author_email": "jacobglapkin@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3c/ab/876b5c7ed2b33417aa7fd3b97dc021827e43177733383d16f4a215811d16/scriptedsketches-0.1.0.tar.gz",
"platform": null,
"description": "# ScriptedSketches\n\nScriptedSketches is an innovative Python package that brings the power of OpenAI's GPT-4 directly to your terminal, allowing you to generate ASCII art from textual descriptions. Designed with simplicity and ease of use in mind, ScriptedSketches opens up a world of creative possibilities for both developers and artists alike. \n\n## Features \n\n- **Ease of Use**: Generate art directly from the command line.\n- **Powered by GPT-4**: Leverages the latest in AI technology for detailed and accurate art. \n- **Custom Artwork**: Transforms your descriptions into unique ASCII art. \n- **On-the-Fly Creation**: Instantly renders artwork in the terminal window.\n\n## Installation \n\nTo get started with ScriptedSketches, install the package using pip:\n\n```bash \npip install scriptedsketches\n```\n\nThis command will download and install ScriptedSketches along with its dependencies. Ensure you have Python 3.6 or newer, as this is required for the package to function correctly.\n\n## Configuration \n\nBefore using ScriptedSketches, you must obtain an API key from OpenAI and set it as an environment variable on your system. This key enables the package to communicate with OpenAI's API to generate ASCII art scripts. \n\n### Setting Up the OPENAI_API_KEY\n\n**For Linux and macOS Users:** \n\nOpen your terminal. \nRun the following command:\n```\nexport OPENAI_API_KEY='your_openai_api_key_here'\n```\n\nTo make this change permanent, add the export command to your shell's startup script, such as ~/.bashrc, ~/.zshrc, or ~/.profile.\n\n**For Windows Users:** \n\nOpen Command Prompt. \nRun the following command:\n```\nsetx OPENAI_API_KEY \"your_openai_api_key_here\"\n```\n\nRestart Command Prompt to apply the changes. \n\n**Important**: Keep your API key secure and never commit it in your version-controlled files.\n\n## Usage \n\nOnce installed and configured, generate ASCII art by simply typing:\n```\nscriptedsketches \"describe your image here\"\n```\n\nThe terminal will display the ASCII art generated based on your description. \n\n## How It Works \n\nWhen you run the scriptedsketches command, the package communicates with the OpenAI API, sending your descriptive prompt to be processed by the GPT-4 model. The model then returns a Python script tailored to your description, which is executed locally to render your ASCII art in the terminal.\n\n## Contributing \n\nWe welcome contributions to ScriptedSketches! If you have suggestions for improvements or encounter any issues, please feel free to open an issue or submit a pull request.\n\n- Fork the Project \n- Create your Feature Branch (git checkout -b feature/AmazingFeature)\n- Commit your Changes (git commit -m 'Add some AmazingFeature') \n- Push to the Branch (git push origin feature/AmazingFeature)\n- Open a Pull Request \n\n## License \n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Acknowledgments \n\n- Thanks to OpenAI for providing the GPT-4 API. \n- Hat tip to all contributors who have helped shape this project. \n\n## Questions or Feedback\n\nFor any questions or feedback, please contact the project maintainer at jacobglapkin@gmail.com. Your input is valuable to us! \n\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A package that allows you to create terminal art powered by GPT-4",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/yourusername/scriptedsketches"
},
"split_keywords": [
"terminal",
"art",
"gpt-4-turbo"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4dd040c5a92fe924e7ec4a7bdded89475beb093f80bbc0c094188e32c9bb57ec",
"md5": "2d4e833d6d647576e2da7053e2c19d63",
"sha256": "1736161ea00c4daa25b7b695bd4be4e7851082f0c931636c5975a39d865437d4"
},
"downloads": -1,
"filename": "scriptedsketches-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2d4e833d6d647576e2da7053e2c19d63",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 7883,
"upload_time": "2024-02-03T00:13:53",
"upload_time_iso_8601": "2024-02-03T00:13:53.978361Z",
"url": "https://files.pythonhosted.org/packages/4d/d0/40c5a92fe924e7ec4a7bdded89475beb093f80bbc0c094188e32c9bb57ec/scriptedsketches-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3cab876b5c7ed2b33417aa7fd3b97dc021827e43177733383d16f4a215811d16",
"md5": "7684d5e24e3c436e1c14453e54b07d68",
"sha256": "39e13018ffe9117faafb7b0ac3103f0d87d4a9ef2b7b8e12bda52ab775575e09"
},
"downloads": -1,
"filename": "scriptedsketches-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "7684d5e24e3c436e1c14453e54b07d68",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 6688,
"upload_time": "2024-02-03T00:13:55",
"upload_time_iso_8601": "2024-02-03T00:13:55.373044Z",
"url": "https://files.pythonhosted.org/packages/3c/ab/876b5c7ed2b33417aa7fd3b97dc021827e43177733383d16f4a215811d16/scriptedsketches-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-03 00:13:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "scriptedsketches",
"github_not_found": true,
"lcname": "scriptedsketches"
}
JSON
