README

mhinspeya/module-hyva-aiimages

• Main Functionalities
• Installation
• Configuration
• How It Works
• Generated Image Management
• Specifications
• Attributes

Main Functionalities

The MHinspeya Hyvä AI Inspiration Image Generator module allows Magento 2 merchants to generate AI-powered inspiration images for products based on:

• Style (e.g., Modern, Retro, Streetwear, Minimal)
• Scene (Studio, Outdoor, Lifestyle, Flat Lay)
• Gender (Male, Female, Unisex)

🧠 Important:
This module does not replace product images and does not save images into Magento’s media gallery.

Instead:

• AI-generated images are stored in a custom database table.
• Images are shown in a separate admin section.
• You get a dedicated page to browse all generated images with filters based on style, scene, and gender.

Installation

* For production environments, use: --keep-generated.

Type 1: Zip File Installation

1. Extract to:

   app/code/MHinspeya/Inspiration
   

2. Enable module:

   php bin/magento module:enable MHinspeya_Inspiration
   

3. Run upgrade:

   php bin/magento setup:upgrade
   

4. Flush cache:

   php bin/magento cache:flush
   

Type 2: Composer Installation

1. Add repository (if private):

   composer config repositories.inspeya composer https://repo.inspeya.com/
   

2. Install module:

   composer require mhinspeya/module-hyva-aiimages
   

3. Enable module:

   php bin/magento module:enable MHinspeya_Inspiration
   

4. Upgrade:

   php bin/magento setup:upgrade
   

5. Clear cache:

   php bin/magento cache:flush
   

Configuration

Admin path:

Stores → Configuration → MHinspeya → AI Inspiration Images

Available Settings:

• API Provider (OpenAI, Stable Diffusion, Custom model)
• API Key
• Default Style / Scene / Gender
• Generated image resolution
• Cleanup behavior (keep or auto-delete old generations)

How It Works

1. Admin visits product editing page.
2. Opens the AI Inspiration Image Generator section.
3. Selects:
   • Style
   • Scene
   • Gender
4. Clicks Generate Image.
5. The module calls the configured AI model API.
6. The generated image is:
   • Stored in a custom table
   • Displayed in the UI for preview
   • NOT added to Magento media gallery

Generated Image Management

The module adds a new admin page:

Marketing → AI Inspiration Images

This page shows:

• ✔ All AI-generated images
• ✔ Filters for:
  • Style
  • Scene
  • Gender
  • Product
  • Date
• ✔ Pagination
• ✔ Large image preview
• ✔ Internal ID, prompt details, and meta information

This lets you review and manage thousands of generated images without touching product media.

Specifications

Attributes

This module does not add product attributes.
Instead, it introduces:

• Custom DB table for AI-generated images
• Admin UI component for image listing
• Filters for:
  • Style
  • Scene
  • Gender

© MHinspeya — All Rights Reserved