🌺 Hibiscus

AI-powered creative studio for image and video generation

---

✨ Features

Feature	Description
🎨 Image Generation	Create stunning images with Flux, Turbo, GPT-Image, and more
✏️ Image Editing	Transform existing images with AI-powered img2img
🎬 Video Generation	Generate videos with Veo, Seedance models
� Gallery Search	Real-time search by prompt in your gallery
🚀 Parallel Generation	Generate multiple images/videos simultaneously
📁 Smart Gallery	Automatic organization by date with model badges
💾 Auto-Download	Save creations automatically to organized folders
📂 Custom Media Dir	Choose where to save your creations
🔄 Smart Retry	Exponential backoff + safety filter persistence
🌍 Multi-Language	Portuguese, English, and Spanish
🎭 Themes	Dark and Light mode support

---

� Quick Start

Hibiscus runs as a local web server. You can access it via your browser.

1. Install Dependencies:

   npm install

2. Start the App:

   Windows:

   run.bat

   Generic (Node.js):

   npm start

   The app will open at http://localhost:3333

---

🎮 How to Use

1. Choose Language - Select PT/EN/ES on first run
2. Generate Image - Enter prompt → Select model & settings → Generate
3. Edit Image - Paste (Ctrl+V) or Upload image(s) → Describe changes → Apply
4. Generate Video - Enter prompt → Choose duration → Generate
5. Gallery - View, search, download, edit, or delete creations
6. Settings - Configure API key, auto-download, theme

---

🔑 API Key

For higher rate limits and premium models, get your API key at:

---

📁 Project Structure

Hibiscus/
├── app/
│   ├── index.html      # Main UI
│   ├── styles.css      # Styling (Imports) 
│   ├── app.js          # Frontend logic
│   ├── server.js       # Backend server (Express)
│   ├── css/            # Modular CSS
│   │   ├── core/       # Variables, reset, animations
│   │   ├── layout/     # Layout scaffolding
│   │   ├── components/ # UI components
│   │   └── modules/    # Feature-specific styles
│   ├── modules/        # JavaScript Modules
│   │   ├── core/       # Core utilities (api, utils)
│   │   ├── gallery/    # Gallery logic
│   │   ├── generators/ # Image/Video generation logic
│   │   ├── ui/         # UI management
│   │   ├── i18n.js     # Internationalization
│   │   ├── logger.js   # Logging system
│   │   ├── state.js    # State management
│   │   └── backend.js  # Backend API client
│   └── gallery/        # Saved Media Storage used by server
│       ├── images/     # By date (DD-MM-YYYY)
│       └── videos/     # By date (DD-MM-YYYY)
├── run.bat             # Windows Start Script
└── package.json        # Dependencies

---

� Changelog

v2.0.0 (Hibiscus sabdariffa)

• 🚀 Web Architecture - Removed Electron dependency, now runs as a lightweight Node.js server
• 🔍 Gallery Search - Filter gallery items by prompt instantly
• ⚡ Parallel Generation - Support for multiple simultaneous generation jobs
• 🎬 Video Generation - Added Wan model
• 📋 Paste Support - Paste images directly into the editor
• ⭐ Favorites - Persist favorite items via backend API

v1.2.0 (January 2026)

• 🔢 Resolution Multiplier - 1x, 2x, 4x toggle for high-res output on image & img2img
• 📐 Extended Aspect Ratios - 10 presets: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
• 🛡️ Improved Safety Retry - More robust error handling, fewer false cancellations
• 🎨 UI Consistency - Unified button styling across the app

v1.1.0 (January 2026)

• ✨ Modular Architecture - Code split into reusable modules (i18n, logger, state, backend)
• 🎲 Random Seed Fix - Each generation now produces unique results
• 🏷️ Model Badges - Gallery shows which model was used for each creation
• 📂 Custom Media Directory - Choose where to save your files

---

📝 License

MIT License - Feel free to use, modify, and distribute.

---

Made with 🤍 by Hirothewolf
Powered by 🐝 Pollinations.ai