Update README.md
Browse files
README.md
CHANGED
@@ -1,3 +1,96 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
---
|
2 |
title: Img Genwebapp
|
3 |
emoji: πΌ
|
@@ -10,4 +103,6 @@ pinned: false
|
|
10 |
license: mit
|
11 |
---
|
12 |
|
13 |
-
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
|
|
|
|
|
1 |
+
# π¨ AI Image Generator Web App
|
2 |
+
|
3 |
+
Welcome to the **AI Image Generator** web application! This app allows you to generate stunning photorealistic images from text prompts using cutting-edge AI technology.
|
4 |
+
|
5 |
+
### π Live Demo
|
6 |
+
Check out the live version of the app hosted on Hugging Face Spaces:
|
7 |
+
[AI Image Generator](https://huggingface.co/spaces/sumityadav329/text-to-image-webapp)
|
8 |
+
|
9 |
+
---
|
10 |
+
|
11 |
+
## π Features
|
12 |
+
|
13 |
+
- **Text-to-Image Generation**: Generate high-quality, photorealistic images from detailed prompts.
|
14 |
+
- **Enhanced Realism**: Automatically enriches prompts for better results.
|
15 |
+
- **Error Handling**: Robust handling for empty prompts or API issues.
|
16 |
+
- **Streamlined UI**: Simple and elegant interface powered by Gradio.
|
17 |
+
- **Status Feedback**: Displays generation status to keep you informed.
|
18 |
+
|
19 |
+
---
|
20 |
+
|
21 |
+
## π οΈ How It Works
|
22 |
+
|
23 |
+
1. **Input Prompt**: Enter a detailed description of the image you want to generate. For example:
|
24 |
+
- *"Photorealistic portrait of a woman in natural light"*
|
25 |
+
- *"Astronaut riding a bike on Mars during sunset"*
|
26 |
+
|
27 |
+
2. **Generate Image**: Click on the **β¨ Generate Image** button.
|
28 |
+
|
29 |
+
3. **View Result**: The generated image will appear alongside a status message.
|
30 |
+
|
31 |
+
---
|
32 |
+
|
33 |
+
## π» Technologies Used
|
34 |
+
|
35 |
+
- **Gradio**: For building the interactive web application.
|
36 |
+
- **Hugging Face Inference API**: For accessing the Stable Diffusion model.
|
37 |
+
- **PIL (Python Imaging Library)**: For handling and displaying images.
|
38 |
+
|
39 |
+
---
|
40 |
+
|
41 |
+
## π Repository
|
42 |
+
|
43 |
+
This project is version-controlled and hosted on GitHub. It is also integrated with Hugging Face Spaces for seamless updates.
|
44 |
+
You can clone the repository to explore or contribute to the codebase:
|
45 |
+
|
46 |
+
```bash
|
47 |
+
git clone https://github.com/sumityadav329/text-to-image-webapp.git
|
48 |
+
```
|
49 |
+
|
50 |
+
---
|
51 |
+
|
52 |
+
## π Requirements
|
53 |
+
|
54 |
+
- Python 3.10+
|
55 |
+
- Install dependencies:
|
56 |
+
```bash
|
57 |
+
pip install -r requirements.txt
|
58 |
+
```
|
59 |
+
- Hugging Face Token: Set your **HF_TOKEN** in a `.env` file.
|
60 |
+
|
61 |
+
---
|
62 |
+
|
63 |
+
## β‘ Quick Start
|
64 |
+
|
65 |
+
1. Clone the repository:
|
66 |
+
```bash
|
67 |
+
git clone https://github.com/sumityadav329/text-to-image-webapp.git
|
68 |
+
cd text-to-image-webapp
|
69 |
+
```
|
70 |
+
|
71 |
+
2. Install the required packages:
|
72 |
+
```bash
|
73 |
+
pip install -r requirements.txt
|
74 |
+
```
|
75 |
+
|
76 |
+
3. Run the app locally:
|
77 |
+
```bash
|
78 |
+
gradio app.py
|
79 |
+
```
|
80 |
+
|
81 |
+
4. Access the app at [http://localhost:7860](http://localhost:7860).
|
82 |
+
|
83 |
+
---
|
84 |
+
|
85 |
+
## β€οΈ Credits
|
86 |
+
|
87 |
+
- **Developer**: Sumit Yadav
|
88 |
+
- **Hosting**: Hugging Face Spaces
|
89 |
+
- **Model**: StabilityAI's Stable Diffusion XL
|
90 |
+
|
91 |
+
Feel free to fork, modify, or contribute to this project! π
|
92 |
+
|
93 |
+
|
94 |
---
|
95 |
title: Img Genwebapp
|
96 |
emoji: πΌ
|
|
|
103 |
license: mit
|
104 |
---
|
105 |
|
106 |
+
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
107 |
+
|
108 |
+
|