Hugging Face's logo

Spaces:
Agents-MCP-Hackathon
/
project-visualizer-agent
Runtime error

App Files Community
project-visualizer-agent
File size: 3,016 Bytes
4c063b9
dc72206
4c063b9
 
 
 
 
 
 
dc72206
 
4c063b9
 
f06205a
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4c063b9
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
---
title: Project Visualizer Agent
emoji: 🖼
colorFrom: purple
colorTo: red
sdk: gradio
sdk_version: 5.25.2
app_file: app.py
pinned: false
license: mit
short_description: This tool uses an AI-powered image generation model to creat
---

**Track:** `mcp-server-track`

---

# 🧠 Project Visualizer Agent

**Turn your project ideas into visuals — instantly.**  
This tool uses an AI-powered image generation model to create high-quality illustrations based on detailed project descriptions.

---

## 🚀 Overview

The **Project Visualizer Agent** is built for makers, designers, and thinkers who want to:

- Quickly visualize abstract concepts.
- Generate artwork for startup ideas, product pitches, or research projects.
- Use curated prompt templates to boost creativity and save time.

It leverages an OpenAI-compatible image generation API and provides advanced controls over image size, inference steps, and seed values.

---

## 🖼️ Features

✅ Text-to-image generation  
✅ Preloaded detailed prompt examples  
✅ Negative prompt support  
✅ Adjustable image dimensions  
✅ Random or fixed seed option  
✅ Simple and fast Gradio UI  

---

## 🧪 Sample Prompts

Examples you can select directly in the app:

- **Smart Farming Dashboard**  
  *A rice paddy at dawn, sensors glowing, farmer holding a holographic dashboard.*

- **Voice-Based Study Companion**  
  *Teen speaking to an AI pod, cozy twilight setup, floating quiz bubbles.*

- **Elderly Health Alert System**  
  *Family scene, wristband alert, daughter holding smartphone showing health graph.*

- **Dream2Scene Storyboard Panel**  
  *Writer in attic, fantasy visuals emerging from typewriter, painterly style.*

(And more…)

---

## 🔧 How to Run

### 1. Clone the repo

### 2. Install dependencies

```bash
pip install -r requirements.txt
```

### 3. Set up environment variables

Create a `.env` file with your Nebius / OpenAI-compatible API credentials:

```env
API_KEY=your_api_key
```

### 4. Run the app

```bash
python app.py
```

---

## 📁 Project Structure

```
.
├── app.py                 # Gradio interface logic
├── utils/
│   └── image.py           # Image generation and saving logic
├── requirements.txt       # Dependencies
└── README.md              # This file
```

---

## 📸 Demo

![screenshot](assets/demo-ui.png)
![alt text](image/20250611_032824.png)
![alt text](image/20250611_035514.png)
---

## ✨ Future Improvements

* Add multi-image comparison
* Integrate actual LLM prompt crafting support
* Enable history and download gallery
* Add animated scene generation

---

## 🧑‍💻 Built With

* [Gradio](https://www.gradio.app/) — for UI
* [Nebius Studio](https://nebius.ai/) Flux Schnell model (OpenAI-compatible)
* Python 🐍

---

## 📬 Contact

Made by **Ritwik Singh**
📧 [officialritwik098@gmail.com](mailto:officialritwik098@gmail.com)


Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference