ImageGenToolKit 0.1.0

Asynchronous AI image generation library with proxy support.

ImageGenToolKit

ImageGenToolKit is a Python library for asynchronous AI image generation with built-in proxy support. This library uses the MagicHour AI platform and handles proxies automatically, making it ideal for generating images in environments with restricted or rate-limited access.

Features

• Asynchronous: Fully async operations for speed and scalability.
• Proxy Support: Automatically fetches and rotates HTTP proxies.
• Customizable: Allows prompt-based image generation with configurable orientation.

---

Installation

Install the library using pip:

pip install ImageGenToolKit

---

Usage

Here’s how to use the library to generate AI-generated images.

Basic Example

import asyncio
from ImageGenToolKit import AIImageGeneratorAsync
async def main():
# Initialize the image generator
gen = AIImageGeneratorAsync()
# Generate an image
prompt = "A futuristic cityscape with glowing neon lights"
urls = await gen.generate_image(prompt, orientation="landscape")

# Print the image URLs
print("Generated Image URLs:", urls)

Run the async function
asyncio.run(main())

Output Example

Generated Image URLs: [
    "https://example.com/image1.png",
    "https://example.com/image2.png"
]

Customizing Orientation

You can specify the orientation as "portrait", "landscape", or "square":

urls = await gen.generate_image("A serene mountain lake", orientation="portrait")

---

Advanced Features

Handling Proxies

The library automatically fetches and uses proxies. You can also fetch proxies manually if needed:

await gen.fetch_proxies()
print(gen.proxy_list)  # List of fetched proxies

Error Handling

Make sure to handle exceptions in case of network issues or invalid proxies:

try:
    urls = await gen.generate_image("A fantasy dragon in flight")
    print(urls)
except Exception as e:
    print("Error generating image:", e)

---

Contributing

1. Fork the repository.
2. Create a feature branch: git checkout -b feature-name.
3. Commit your changes: git commit -m "Add new feature".
4. Push to the branch: git push origin feature-name.
5. Submit a pull request.

---

License

This project is licensed under the MIT License. See the LICENSE file for details.

---

Feel free to reach out with any questions or suggestions! рџљЂ