Here's a clean, regular README.md
format for your project:
Welcome to the AI-Image-Creation-Toolkit! This repository provides all the tools you need to generate AI images on your computer or using cloud-based services. Whether you're new to AI or an experienced user, this toolkit will help you create stunning images with simple Python scripts.
- Local Image Generation: Generate AI images directly on your computer at no cost.
- Cloud-Based Image Generation: Leverage Hugging Face's API to generate images in the cloud, with up to 100 free images per month.
- Google Colab Integration: Speed up image generation by running scripts on Google Colab using free GPUs.
- Python 3.x installed on your computer.
- An IDE like VSCode or PyCharm (optional but recommended).
- A Hugging Face account for cloud-based image generation.
-
Clone the Repository
Clone the repository to your local machine:
git clone https://github.com/your-username/AI-Image-Creation-Toolkit.git cd AI-Image-Creation-Toolkit
-
Install the Required Libraries
If you're running the scripts locally, install the necessary Python libraries:
pip install -r requirements.txt
This command will install the following libraries:
- diffusers: A library for creating and working with diffusion models used in image generation.
- transformers: Hugging Face’s library for handling pre-trained models and running inference.
- requests: A simple library for making HTTP requests, useful for accessing Hugging Face’s API.
- Pillow: A Python Imaging Library (PIL) fork, useful for image processing tasks like saving and displaying images.
To generate images locally on your computer:
- Open the
local.py
script in your IDE. - Customize the
prompt
variable with your desired image description. - Run the script.
The generated image will be saved as output.png
in the project directory.
To generate images using Hugging Face’s cloud API:
- Open the
cloud.py
script in your IDE. - Replace
your_huggingface_api_token
with your Hugging Face API key. - Customize the
prompt
variable with your desired image description. - Run the script.
The generated image will be saved as output.png
in the project directory.
If you want to leverage Google Colab’s free GPUs:
-
Upload the
local.py
orcloud.py
script to a new Google Colab notebook. -
Install the necessary libraries in the Colab environment:
!pip install diffusers transformers requests pillow
-
Run the script to generate your images faster using Colab’s GPU resources.
Watch our step-by-step video tutorial to see these methods in action:
(Click the image above to watch the video on YouTube)
Contributions are welcome! Feel free to open issues, suggest features, or submit pull requests to improve this project.
This project is licensed under the MIT License - see the LICENSE file for details.
- Hugging Face: For providing the API used in cloud-based image generation.
- Diffusers Library: For the tools used to generate images locally.
You can use this Markdown text as your README.md
file. Just remember to replace your-username
and VIDEO_ID_HERE
with your specific details.