masilia / ibexa-ai-editor
AI help inside the Ibexa content editing form: suggestions for each field and image generation
Package info
github.com/MasiliaLabs/ibexa-ai-editor
Type:ibexa-bundle
pkg:composer/masilia/ibexa-ai-editor
Requires
- php: >=8.3
- ibexa/admin-ui: ^5.0
- ibexa/core: ^5.0
- masilia/ibexa-ai: ^2.0
- neuron-core/neuron-ai: ^4.1
- psr/log: ^3.0
- symfony/config: ^7.4
- symfony/dependency-injection: ^7.4
- symfony/http-foundation: ^7.4
- symfony/http-kernel: ^7.4
- symfony/routing: ^7.4
Requires (Dev)
- ibexa/fieldtype-matrix: ^5.0
- ibexa/fieldtype-richtext: ^5.0
- phpstan/phpstan: ^2.1
- phpunit/phpunit: ^11.5
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
AI help inside the Ibexa content editing form: a suggestion for each field, and image generation.
masilia/ibexa-ai-editor is part of a family of packages for Ibexa that work together or alone. See the other packages.
What it is
AI help inside the Ibexa content editing form: next to each field an editor can ask for a suggestion, and for image fields generate a picture from a short brief. It uses the providers and the rules of masilia/ibexa-ai — it talks to it only through its contracts.
Features
- A suggestion for each field: pick one of the actions (the server applies its own instruction and its faithfulness rules) or write your own prompt. The text streams into a modal and rich text is sanitised before it reaches the editor.
- Image generation for image fields: the model gets a brief built from the content (what the item is about), not from a list of form fields.
- Admin-native: controllers use Ibexa's access checks and the admin's CSRF token, routes belong to the admin siteaccess group.
- Same providers as the assistant: whatever provider answers for the siteaccess in
masilia/ibexa-aiis used here.
Requirements
- PHP 8.3 or later
- Ibexa 5.0 (Symfony 7.4)
Installed with it by Composer:
masilia/ibexa-aithe providers, the rules and the contracts
Installation
composer require masilia/ibexa-ai-editor
-
Enable the bundles in
config/bundles.php(masilia/ibexa-aimust be set up first, see its README):Masilia\Bundle\IbexaAiEditor\MasiliaIbexaAiEditorBundle::class => ['all' => true],
-
Import the routes (
config/routes/masilia_ibexa_ai_editor.yaml):masilia_ibexa_ai_editor: resource: '@MasiliaIbexaAiEditorBundle/Resources/config/routes.yaml'
-
Build the admin assets:
yarn ibexa-generate-tsconfig php bin/console ibexa:encore:compile
Inside DDEV, prefix each command with
ddev exec. The admin build isibexa:encore:compile:yarn encore dev --config-name ibexadoes not work ("Configuration with the name ibexa was not found"), and a plainyarn encore devdoes not build the admin on a project that has not merged the Ibexa configuration into itswebpack.config.js.
With Symfony Flex
The Masilia recipes do the first steps for you. Add their endpoint once to the composer.json of your project, after the one of Ibexa:
"extra": { "symfony": { "endpoint": [ "https://api.github.com/repos/ibexa/recipes/contents/index.json?ref=flex/main", "https://api.github.com/repos/MasiliaLabs/recipes/contents/index.json?ref=flex/main", "flex://defaults" ] } }
Then composer require masilia/ibexa-ai-editor enables the bundle and writes config/routes/masilia_ibexa_ai_editor.yaml. What is left is yours: the admin build (masilia/ibexa-ai must be set up first). The manual steps above and below stay valid.
Usage
Edit a content in the admin. Open the AI help of a field, pick an action or write a prompt, read the suggestion as it streams, and accept it into the field. Image generation needs a provider that supports images (set its image model in AI Assistant).
Tests
composer install vendor/bin/phpunit vendor/bin/phpstan analyse --memory-limit=2G --no-progress
The tests of the admin scripts run with Node (see CONTRIBUTING.md).
AI agent skill
This package ships a skill for AI coding agents (Claude Code and other agents that read SKILL.md skills): how to install, configure, operate and troubleshoot masilia/ibexa-ai-editor. It lives in skills/masilia-ibexa-ai-editor and comes with the package.
# For the project (committed with it): from the installed package mkdir -p .claude/skills && cp -r vendor/masilia/ibexa-ai-editor/skills/masilia-ibexa-ai-editor .claude/skills/ # For all your projects: global mkdir -p ~/.claude/skills && cp -r vendor/masilia/ibexa-ai-editor/skills/masilia-ibexa-ai-editor ~/.claude/skills/
Restart the agent (or reload its skills) to pick it up. Update the copy after composer update.
The Masilia packages
| Package | What it does |
|---|---|
masilia/ibexa-admin-kit |
React components in the design of the Ibexa admin, for admin pages |
masilia/ibexa-sites |
A registry of sites that Ibexa serves without a deploy |
masilia/ibexa-ai |
The AI assistant for Ibexa: capabilities, providers, chat, approval flow |
masilia/ibexa-ai-craft |
The assistant builds sites and pages out of blocks |
masilia/ibexa-ai-editor |
AI suggestions and image generation in the content editing form |
masilia/ibexa-blocks |
Front-office rendering of pages made of blocks, with themes |
masilia/editorial-toolbox |
In-context editing toolbar for the front office |
What requires what (Composer installs it for you):
ibexa-sitesrequiresibexa-admin-kitibexa-airequiresibexa-admin-kitibexa-ai-editorrequiresibexa-aiibexa-ai-craftrequiresibexa-ai,ibexa-blocksandibexa-sitesibexa-blocksandeditorial-toolboxrequire none of the others; they are happy to findibexa-sites(and each other) when installed.
Compatibility
| Package version | PHP | Ibexa |
|---|---|---|
latest |
8.3+ | 5.0 |
Download
- Composer (recommended):
composer require masilia/ibexa-ai-editor— ibexa-ai-editor on Packagist - Archive of a release: GitHub releases (each release lists what changed)
- Source:
git clone https://github.com/MasiliaLabs/ibexa-ai-editor.git - What changed between versions: CHANGELOG.md
Support, contributing and security
- Questions and bug reports: GitHub issues
- Upgrading across a breaking change: UPGRADE.md
- Pull requests are welcome, see CONTRIBUTING.md
- Security problems: please follow SECURITY.md and do not open a public issue
License
Released under the MIT license. Copyright © 2026 MasiliaLabs.
Ibexa itself is distributed under its own licenses (Ibexa OSS: GPL-2.0), which apply to the project that uses this package. This package is an independent project, not affiliated with or endorsed by Ibexa AS; "Ibexa" is a trademark of its owner.