multi_image / README.md
mrbeniwal's picture
Update README with Hugging Face Space metadata and formatting
9a4e7bf
---
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.