# PyImagine
[](https://github.com/hyugogirubato/pyimagine/blob/main/LICENSE)
[](https://github.com/hyugogirubato/pyimagine/releases)
[](https://pypi.org/project/pyimagine/)
PyImagine is a Python library for AI-powered image manipulation. It provides a simple interface to interact with an
image manipulation service, allowing you to perform various operations on images.
## Features
- Generate inspired images based on predefined prompts and styles.
- Apply variations to images based on prompts, strengths, and styles.
- Enhance image resolution and quality using AI-powered upscaling.
- Generate prompts based on the content of images.
- Fill in missing or corrupted parts of images.
- Remix images by applying control prompts, strengths, and styles.
- Fix and enhance facial features in images.
## Installation
You can install PyImagine using pip:
````shell
pip install pyimagine
````
## Usage
Here's a basic example of how to use PyImagine:
````python
from pyimagine import Arta
from pyimagine.constants import Style
# Initialize Imagine
arta = Arta()
arta.signupNewUser()
# Generate from inspiration
inspired_image = arta.infer(prompt="Create something amazing!", style=Style.REALISTIC_2)
# Prompt from image
original_image = open('image.jpg', 'rb').read()
prompt_image = arta.image2text(original_image, language_code='en')
# And more...
````
For more information on how to use PyImagine, please refer to
the [documentation](https://github.com/hyugogirubato/pyimagine/blob/main/docs).
## Disclaimer
PyImagine is an unofficial library and is not affiliated with or endorsed by Vyroai or Aiby. The library is provided "as
is" without any warranty, and the usage of this library is at your own risk. Make sure to comply with the terms and
conditions of the Imagine service while using this library.
### License
This project is licensed under the [GPL v3 License](https://github.com/hyugogirubato/pyimagine/blob/main/LICENSE).
Raw data
{
"_id": null,
"home_page": "https://github.com/hyugogirubato/pyimagine",
"name": "pyimagine",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "art,image,ai,stable-diffusion",
"author": "hyugogirubato",
"author_email": "hyugogirubato@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/23/ba/a26e21d09c8690a914f7bea8fdbbcbe937de1f857e401a737cf686300a18/pyimagine-3.3.8.tar.gz",
"platform": null,
"description": "# PyImagine\r\n\r\n[](https://github.com/hyugogirubato/pyimagine/blob/main/LICENSE)\r\n[](https://github.com/hyugogirubato/pyimagine/releases)\r\n[](https://pypi.org/project/pyimagine/)\r\n\r\nPyImagine is a Python library for AI-powered image manipulation. It provides a simple interface to interact with an\r\nimage manipulation service, allowing you to perform various operations on images.\r\n\r\n## Features\r\n\r\n- Generate inspired images based on predefined prompts and styles.\r\n- Apply variations to images based on prompts, strengths, and styles.\r\n- Enhance image resolution and quality using AI-powered upscaling.\r\n- Generate prompts based on the content of images.\r\n- Fill in missing or corrupted parts of images.\r\n- Remix images by applying control prompts, strengths, and styles.\r\n- Fix and enhance facial features in images.\r\n\r\n## Installation\r\n\r\nYou can install PyImagine using pip:\r\n\r\n````shell\r\npip install pyimagine\r\n````\r\n\r\n## Usage\r\n\r\nHere's a basic example of how to use PyImagine:\r\n\r\n````python\r\nfrom pyimagine import Arta\r\nfrom pyimagine.constants import Style\r\n\r\n# Initialize Imagine\r\narta = Arta()\r\narta.signupNewUser()\r\n\r\n# Generate from inspiration\r\ninspired_image = arta.infer(prompt=\"Create something amazing!\", style=Style.REALISTIC_2)\r\n\r\n# Prompt from image\r\noriginal_image = open('image.jpg', 'rb').read()\r\nprompt_image = arta.image2text(original_image, language_code='en')\r\n\r\n# And more...\r\n````\r\n\r\nFor more information on how to use PyImagine, please refer to\r\nthe [documentation](https://github.com/hyugogirubato/pyimagine/blob/main/docs).\r\n\r\n## Disclaimer\r\n\r\nPyImagine is an unofficial library and is not affiliated with or endorsed by Vyroai or Aiby. The library is provided \"as\r\nis\" without any warranty, and the usage of this library is at your own risk. Make sure to comply with the terms and\r\nconditions of the Imagine service while using this library.\r\n\r\n### License\r\n\r\nThis project is licensed under the [GPL v3 License](https://github.com/hyugogirubato/pyimagine/blob/main/LICENSE).\r\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "Python library for AI-powered image manipulation.",
"version": "3.3.8",
"project_urls": {
"Homepage": "https://github.com/hyugogirubato/pyimagine"
},
"split_keywords": [
"art",
"image",
"ai",
"stable-diffusion"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "23baa26e21d09c8690a914f7bea8fdbbcbe937de1f857e401a737cf686300a18",
"md5": "28a36c25bf4571b1be9ef35bf45203f3",
"sha256": "24f0ce9b712e5bad17ead70e6d92ae3ee0155881f7a57360d8cc122e130fedac"
},
"downloads": -1,
"filename": "pyimagine-3.3.8.tar.gz",
"has_sig": false,
"md5_digest": "28a36c25bf4571b1be9ef35bf45203f3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 34501,
"upload_time": "2024-01-27T22:09:28",
"upload_time_iso_8601": "2024-01-27T22:09:28.967303Z",
"url": "https://files.pythonhosted.org/packages/23/ba/a26e21d09c8690a914f7bea8fdbbcbe937de1f857e401a737cf686300a18/pyimagine-3.3.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-27 22:09:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hyugogirubato",
"github_project": "pyimagine",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pyimagine"
}
JSON
