PHPackages                             acseo/sylius-ai-tools - 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. acseo/sylius-ai-tools

ActiveSylius-plugin[Utility &amp; Helpers](/categories/utility)

acseo/sylius-ai-tools
=====================

Use AI to improve eShop experience

v1(1y ago)242[1 PRs](https://github.com/acseo/sylius-ai-tools/pulls)MITPHPPHP ^8.2

Since Nov 12Pushed 1y ago4 watchersCompare

[ Source](https://github.com/acseo/sylius-ai-tools)[ Packagist](https://packagist.org/packages/acseo/sylius-ai-tools)[ RSS](/packages/acseo-sylius-ai-tools/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (10)Versions (2)Used By (0)

 [ ACSEO ](https://www.acseo.fr)

Sylius AI Tools
 [ ![](https://camo.githubusercontent.com/d209fb8e07acc42d48bca11f002c317f37a771a0af518ed60ba161f69efc0db7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f616373656f2f73796c6975732d61692d746f6f6c732e737667) ](https://packagist.org/packages/acseo/sylius-ai-tools "License") [ ![](https://camo.githubusercontent.com/9d931841307014c0db8a0449696bb6d2e8bd6185992a6a61d1b1514b1f8e9b51/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616373656f2f73796c6975732d61692d746f6f6c732e737667) ](https://packagist.org/packages/acseo/sylius-ai-tools "Version")
=============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#sylius-ai-tools--------------------------------)

[![](capture.gif)](capture.gif)

Use AI to improve eShop experience

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

[](#installation)

To integrate the **Sylius AI Tools** into your project, follow these steps:

### Step 1: Install the Package

[](#step-1-install-the-package)

Install **Sylius AI Tools** using Composer. We recommend using stable, supported, and up-to-date versions of packages. Run the following command in your terminal:

```
$ composer require acseo/sylius-ai-tools
```

### Step 2: Register the Plugin

[](#step-2-register-the-plugin)

You need to register the plugin in your Symfony application. Open the config/bundles.php file and add the following line:

```
return [
    ACSEO\SyliusAITools\SyliusAITools::class => ['all' => true],
];
```

### Step 3: Import Required Configuration

[](#step-3-import-required-configuration)

Next, import the required configuration by adding the service definitions to your config/packages/\_sylius.yaml file. Append the following lines:

```
# config/packages/_sylius.yaml
imports:
    - { resource: "@SyliusAITools/Resources/config/services.yaml" }
```

### Step 4: Import Routing Configuration

[](#step-4-import-routing-configuration)

To make the routes available, you need to import the routing configuration. Add the following lines to your config/routes.yaml file:

```
# config/routes.yaml
sylius_admin_ai_tools:
    resource: "@SyliusAITools/Resources/config/routes/sylius_admin.yaml"
```

### Step 5: Finalize the Installation

[](#step-5-finalize-the-installation)

To complete the installation process, clear the cache and update the database schema. Execute the following command:

```
$ bin/console cache:clear
```

### Step 6: Configure Twig Paths

[](#step-6-configure-twig-paths)

Update your Twig configuration to include the plugin's view templates. In your config/packages/twig.yaml, add the following path configuration:

```
twig:
    paths:
        '%kernel.project_dir%/vendor/acseo/sylius-ai-tools/src/Resources/views': ~
```

### Step 7: Add Plugin Templates

[](#step-7-add-plugin-templates)

Copy the plugin templates into your project's template directory. Run the following command:

```
cp -R vendor/acseo/sylius-ai-tools/src/Resources/views/bundles/ templates/bundles/
```

### Step 8: Configure the Environment

[](#step-8-configure-the-environment)

Finally, set up your environment by adding the OpenAI API key to your .env file. Open the file and add the following line:

```
OPENAI_API_KEY=your_api_key_here
```

### Channel Configuration in the Back-Office (BO)

[](#channel-configuration-in-the-back-office-bo)

When configuring the channel in the back-office (BO), it is necessary to add:

- **Host**: Specify the required address or domain for the proper functioning of the channel.
- **Locales**: Add the languages supported or used by the channel.

Ensure these settings are correctly configured for optimal channel integration.

Commands
--------

[](#commands)

### `acseo:generate-product-descriptions`

[](#acseogenerate-product-descriptions)

This command generates and updates product descriptions for all products in the system, using provided text and optional keywords.

#### Usage

[](#usage)

##### Options:

[](#options)

- **--locale=**: The locale to use for generating descriptions. The default locale is en (English).
- **--text=**: The text to be used for generating descriptions. This will be processed to create a description for each product.
- **--keywords=**: A comma-separated list of keywords that will be used to improve the description generation. For example: --keywords="keyword1, keyword2".

##### Example

[](#example)

```
php bin/console acseo:generate-product-descriptions --locale=en --text="Example product description" --keywords="shirt, cotton, casual"
```

This will generate descriptions for all products in the system, using the provided text and keywords.

### acseo:generate-product-descriptions-from-pictures

[](#acseogenerate-product-descriptions-from-pictures)

This command generates and updates product descriptions for all products in the system, using provided pictures (URLs or file paths) and optional keywords.

#### Usage

[](#usage-1)

##### Options:

[](#options-1)

- **--locale=**: The locale to use for generating descriptions. The default locale is en (English).
- **--pictures=**: A comma-separated list of picture URLs or file paths that will be used to generate descriptions. Each image will be processed to derive relevant information for the descriptions.
- **--keywords=**: A comma-separated list of keywords to enhance the description generation. For example: --keywords="keyword1, keyword2".

##### Example

[](#example-1)

```
php bin/console acseo:generate-product-descriptions-from-pictures --locale=fr --pictures="http://example.com/image1.jpg,http://example.com/image2.jpg" --keywords="dress, summer, casual"
```

This will generate descriptions for all products in the system, based on the provided images and keywords.

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity51

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

Unknown

Total

1

Last Release

546d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ec997989c050cb6e9e63f938feebe6018041d2be64df179a744058d534ca6711?d=identicon)[sabrineferchichi](/maintainers/sabrineferchichi)

---

Top Contributors

[![sabrineferchichi](https://avatars.githubusercontent.com/u/32546231?v=4)](https://github.com/sabrineferchichi "sabrineferchichi (3 commits)")

---

Tags

syliussylius-plugin

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/acseo-sylius-ai-tools/health.svg)

```
[![Health](https://phpackages.com/badges/acseo-sylius-ai-tools/health.svg)](https://phpackages.com/packages/acseo-sylius-ai-tools)
```

###  Alternatives

[sylius/refund-plugin

Plugin provides basic refunds functionality for Sylius application.

691.7M14](/packages/sylius-refund-plugin)[stefandoorn/sitemap-plugin

Sitemap Plugin for Sylius

851.0M](/packages/stefandoorn-sitemap-plugin)[monsieurbiz/sylius-rich-editor-plugin

A Rich Editor plugin for Sylius.

75380.8k6](/packages/monsieurbiz-sylius-rich-editor-plugin)[synolia/sylius-scheduler-command-plugin

Scheduler Command Plugin.

34361.5k](/packages/synolia-sylius-scheduler-command-plugin)[odiseoteam/sylius-blog-plugin

This plugin add blog capabilities to your Sylius project

37104.5k](/packages/odiseoteam-sylius-blog-plugin)[webgriffe/sylius-table-rate-shipping-plugin

Provides table rate shipping calculator.

1490.4k](/packages/webgriffe-sylius-table-rate-shipping-plugin)

PHPackages © 2026

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