mirror of
https://github.com/yusufipk/imagen-openrouter.git
synced 2026-09-11 10:36:07 +00:00
Yusuf İpek
45f09260f9
A client-side AI image generation tool using OpenRouter API. Features: - Multi-model support (Gemini, GPT-5, Flux 2, Seedream, Riverflow) - Unlimited reference image uploads with drag & drop - IndexedDB storage for persistent image gallery - Adjustable resolution (1K/2K/4K) and aspect ratios - Batch generation (up to 8 images) - Custom styled dropdown for model selection - Gallery with delete functionality on hover - Full image modal with metadata and recreate option - XSS protection with input sanitization Tech Stack: - Pure HTML/CSS/JavaScript (no dependencies) - IndexedDB for image persistence - OpenRouter API integration License: GPL-3.0
Imagen - AI Image Generation Tool
A powerful client-side AI image generation tool using OpenRouter API. Generate thumbnails, artwork, and creative images with multiple state-of-the-art models.
✨ Features
🎨 Multi-Model Support
- Gemini 2.5 Flash Image - Google's fast image generation
- Gemini 2.5 Flash (Preview) - Preview version with latest features
- Gemini 3 Pro (Preview) - Advanced model, up to 14 reference images
- GPT-5 Image - OpenAI's latest image model
- GPT-5 Image Mini - Faster, smaller GPT-5 variant
- Flux 2 Pro / Max / Flex / Klein - Black Forest Labs models
- Seedream 4.5 - ByteDance's image model
- Riverflow V2 - Fast/Standard/Max variants
📐 Flexible Output Options
- Resolution: 1K, 2K, 4K (Gemini models)
- Aspect Ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2
- Batch Generation: Up to 8 images at once
🖼️ Reference Image Support
- Upload unlimited reference images
- Drag & drop support
- Use generated images as references
- Click X to remove individual references
💾 Persistent Storage
- IndexedDB storage
- Store hundreds of images
- Images persist across browser sessions
🎯 Gallery Features
- View all generated images
- Delete individual images (hover to reveal 🗑️ button)
- Click any image for full view + metadata
- Clear entire gallery option
♻️ Recreate Feature
- Click any image to restore its original settings
- Instantly iterate on previous generations
🚀 Quick Start
- Clone this repository
- Start a local server:
python3 -m http.server 8080 # or npx serve . - Open http://localhost:8080
- Enter your OpenRouter API key
- Write a prompt and click Generate!
🔑 Getting an OpenRouter API Key
- Go to OpenRouter
- Create an account
- Navigate to Keys section
- Create a new API key
- Copy and paste it into the tool
🔒 Privacy & Security
This is a 100% client-side application:
- ✅ API keys are stored in YOUR browser only
- ✅ Generated images are stored in YOUR browser only (IndexedDB)
- ✅ No data is sent to any server except OpenRouter API
- ✅ Safe to deploy as a static website
⌨️ Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Ctrl + Enter |
Generate images |
Escape |
Close image modal |
🛠️ Tech Stack
- Frontend: Pure HTML/CSS/JavaScript (no dependencies)
- API: OpenRouter for model access
- Storage: IndexedDB for image persistence
- Styling: Custom CSS with CSS variables
📁 Project Structure
imagen/
├── index.html # Main UI structure
├── styles.css # Premium dark theme styling
├── app.js # Core logic + API integration
└── README.md # This file
📜 License
This project is licensed under the GNU General Public License v3.0 (GPL-3.0).
You are free to:
- ✅ Use this software for any purpose
- ✅ Study how the software works and modify it
- ✅ Distribute copies of the software
- ✅ Distribute modified versions
Under the condition that:
- 📋 You include the original license and copyright notice
- 📋 You disclose the source code when distributing
- 📋 Modified versions must also be licensed under GPL-3.0
See the LICENSE file for full details.