PHPackages                             elgentos/magento2-ai-category-hero-images - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. elgentos/magento2-ai-category-hero-images

ActiveMagento2-module[Utility &amp; Helpers](/categories/utility)

elgentos/magento2-ai-category-hero-images
=========================================

Generate AI-powered hero images for categories using OpenAI

0.1.4(1y ago)172675[1 PRs](https://github.com/elgentos/magento2-ai-category-hero-images/pulls)OSL-3.0PHPPHP ~8.1.0||~8.2.0||~8.3.0||~8.4.0

Since Apr 25Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/elgentos/magento2-ai-category-hero-images)[ Packagist](https://packagist.org/packages/elgentos/magento2-ai-category-hero-images)[ RSS](/packages/elgentos-magento2-ai-category-hero-images/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (6)Used By (0)

Elgentos AI Category Hero Images
================================

[](#elgentos-ai-category-hero-images)

This Magento 2 extension generates AI-powered hero images for categories using OpenAI's GPT-Image-1 model.

Features
--------

[](#features)

- Button "Generate with AI" in the admin when on the Category edit page
- Console command to generate AI hero images in bulk for categories
- Selects random products from a category and uses their information to generate a prompt
- Enhances the prompt based on product information
- Uses OpenAI's GPT-Image-1 model to create a visually appealing hero image
- Automatically sets the generated image as the category image
- Configurable through the Magento admin panel

Requirements
------------

[](#requirements)

- Magento 2.4.x
- PHP 8.1 or higher
- OpenAI API key
- A [verified organization](https://help.openai.com/en/articles/10910291-api-organization-verification) (after verification it takes about 30 minutes for existing keys to reflect the change)

Installation
------------

[](#installation)

### Composer Installation

[](#composer-installation)

1. `composer require elgentos/magento2-ai-category-hero-images`
2. Run the following commands:

```
bin/magento module:enable Elgentos_AiCategoryHeroImages
bin/magento setup:upgrade
```

Configuration
-------------

[](#configuration)

1. Go to Stores &gt; Configuration &gt; Elgentos &gt; AI Category Hero Images
2. Enable the module
3. Enter your OpenAI API key
4. (Optional) Enter your OpenAI Organization ID if you have one

Usage
-----

[](#usage)

Open a category and click the "Generate with AI" button, followed by optionally adapting the prompt to your liking.

Or run the following command to generate a hero image for a category:

```
bin/magento elgentos:aicategoryhero:generate [category_id]
```

Options:

- `--num-products` or `-p`: Number of products to include in the image (default: 3)

Example:

```
bin/magento elgentos:aicategoryhero:generate 4 --num-products=5
```

How It Works
------------

[](#how-it-works)

1. The extension selects random products from the specified category
2. It generates a prompt based on the category name and product information
3. The enhanced prompt is sent to OpenAI's GPT-Image-1 model using a direct cURL request
4. The generated image is saved to the Magento media directory
5. The image is set as the category image

License
-------

[](#license)

[OSL-3.0](https://opensource.org/licenses/OSL-3.0)

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance53

Moderate activity, may be stable

Popularity24

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

382d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/88a6d8dc588e8f2a0948335563a754687f71304f0bd3b7f7049d4bcdc00a563c?d=identicon)[peterjaap](/maintainers/peterjaap)

![](https://www.gravatar.com/avatar/91631a876a2495358801220afbd8d869040f8917b913c21a99b9984ad26634df?d=identicon)[WouterSteen](/maintainers/WouterSteen)

---

Top Contributors

[![peterjaap](https://avatars.githubusercontent.com/u/431360?v=4)](https://github.com/peterjaap "peterjaap (10 commits)")

### Embed Badge

![Health badge](/badges/elgentos-magento2-ai-category-hero-images/health.svg)

```
[![Health](https://phpackages.com/badges/elgentos-magento2-ai-category-hero-images/health.svg)](https://phpackages.com/packages/elgentos-magento2-ai-category-hero-images)
```

###  Alternatives

[tig/postnl-magento2

TIG Magento 2 PostNL extension

58544.2k4](/packages/tig-postnl-magento2)[lillik/magento2-price-decimal

Magento 2 Price Decimal Precision

111147.5k](/packages/lillik-magento2-price-decimal)[doofinder/doofinder-magento2

Doofinder module for Magento 2

13204.0k1](/packages/doofinder-doofinder-magento2)[mfd/ai-filemetadata

Automatically generates FAL metadata for files by means of public LLMs

1142.1k](/packages/mfd-ai-filemetadata)[magepal/magento2-form-field-manager

Customer and Address Form Fields Manager for Magento2

293.8k](/packages/magepal-magento2-form-field-manager)[eliashaeussler/typo3-solver

Extension for TYPO3 CMS to extend TYPO3's exception handling with AI generated solutions

292.1k](/packages/eliashaeussler-typo3-solver)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
