README.md

---
title: Multi Image Generator
emoji: 🎨
colorFrom: purple
colorTo: blue
sdk: docker
app_file: app.py
pinned: false
---

# Multi Image Generator

A powerful Next.js web application for generating images using multiple AI providers. Generate stunning images with OpenAI DALL-E 3, Google Generative AI, or Qwen - all from one unified interface.

## ✨ Features

- 🤖 **Multi-Provider Support** - Use OpenAI, Google Generative AI, or Qwen
- 🧠 **Smart Model Selection** - Automatically route to the best available provider
- ⚡ **Real-time Generation** - Watch your images come to life
- 📜 **Image History** - Keep track of all your generated images
- 🌓 **Dark/Light Mode** - Comfortable viewing in any lighting
- 🔐 **Secure API Keys** - Manage your API keys privately through settings

## 🎯 Supported Providers

| Provider | Model | Features |
|----------|-------|----------|
| **OpenAI** | DALL-E 3 | High-quality, detailed images |
| **Google** | Imagen 2 | Fast generation, excellent quality |
| **Qwen** | Qwen Image Gen | Cost-effective, good quality |

## 🚀 Quick Start

1. **Visit the Space** and open the application
2. **Add API Keys** - Click settings and add your API keys for providers you want to use
3. **Generate Images** - Enter your prompt and watch the magic happen!

### Getting API Keys

- **OpenAI**: https://platform.openai.com/api-keys
- **Google**: https://ai.google.dev
- **Qwen**: https://dashscope.aliyun.com

## 💻 Local Development

```bash
# Install dependencies
npm install

# Run development server
npm run dev
# App available at http://localhost:9002

# Build for production
npm run build

# Start production server
npm start
```

## 🛠️ Technologies

- **Frontend**: Next.js 15, React 19, TypeScript
- **Styling**: Tailwind CSS, Radix UI
- **AI**: Genkit AI, Google Generative AI SDK
- **Backend**: Next.js API Routes
- **UI Components**: shadcn/ui

## 📝 How It Works

1. **Prompt Enhancement** - Your prompt is automatically improved for better results
2. **Provider Selection** - The app intelligently selects the best available provider
3. **Image Generation** - Request sent to the selected provider
4. **Display & History** - Generated images shown with automatic history tracking

## 🐳 Docker Deployment

This project is configured to run on Hugging Face Spaces using Docker:

```bash
# The Dockerfile handles:
- Node.js environment setup
- Dependency installation
- Next.js build
- Production server startup on port 7860
```

## ⚙️ Configuration

All configuration is handled through the UI:
- API keys are stored locally in your browser
- No sensitive data is stored on the server
- Settings are managed via the settings panel

## 📜 License

MIT License - feel free to use this project for personal or commercial purposes.

## 🤝 Contributing

Have ideas to improve Multi Image Generator? Feel free to:
- Report issues
- Suggest features
- Submit pull requests

## 📧 Support

For issues or questions about using the app, please check the settings panel for API key configuration help.