Python library for AI-powered image manipulation.
Project description
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:
pip install pyimagine
Usage
Here's a basic example of how to use PyImagine:
from pyimagine import Imagine
from pyimagine.constants import Inspiration
# Initialize Imagine
imagine = Imagine()
# Generate an inspired image
inspired_image = imagine.sdinsp(Inspiration.INSPIRATION_01)
# Variate an image
original_image = open("image.jpg", "rb").read()
variated_image = imagine.variate(original_image, prompt="Create something amazing!")
# Upscale an image
upscaled_image = imagine.upscale(original_image)
# And more...
For more information on how to use PyImagine, please refer to the documentation.
Exceptions
The following exceptions can be raised by PyImagine:
InvalidWord
: Raised when a banned word is found in the prompt. By default, if therestricted
flag is set toTrue
during initialization, the library will raise anInvalidWord
exception. You can customize this behavior by settingrestricted
toFalse
to replace banned words with alternative words instead of raising an exception.InvalidSize
: Raised when attempting to perform an operation that requires both images to have the same size.
Disclaimer
PyImagine is an unofficial library and is not affiliated with or endorsed by Imagine or Vyroai. 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.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file pyimagine-2.7.2.tar.gz
.
File metadata
- Download URL: pyimagine-2.7.2.tar.gz
- Upload date:
- Size: 34.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.11
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | cb6e6a16067ba1c97c9c2bd5ded6d5430c21f6abc226c48f00d6c04d7d48fcd4 |
|
MD5 | 12103e6f5af56c96e524a6607332b5d2 |
|
BLAKE2b-256 | e6cfa59137a2ebdf2ed5188c35433aef4f4f6402527fc822555c31b545f3cd7c |