masilia / ibexa-ai
AI assistant for Ibexa CMS 5: provider layer, content suggestions, agent with approval flow (Neuron AI)
Requires
- php: >=8.3
- ext-curl: *
- ext-dom: *
- ext-intl: *
- ext-pdo: *
- ext-sodium: *
- doctrine/doctrine-bundle: ^2.18
- doctrine/doctrine-migrations-bundle: ^3.4
- doctrine/orm: ^2.20
- ibexa/admin-ui: ^5.0
- ibexa/core: ^5.0
- ibexa/rest: ^5.0
- masilia/ibexa-admin-kit: ^0.1.1
- neuron-core/neuron-ai: ^4.1
- psr/cache: ^3.0
- psr/log: ^3.0
- symfony/config: ^7.4
- symfony/console: ^7.4
- symfony/dependency-injection: ^7.4
- symfony/event-dispatcher: ^7.4
- symfony/framework-bundle: ^7.4
- symfony/http-client: ^7.4
- symfony/http-foundation: ^7.4
- symfony/http-kernel: ^7.4
- symfony/routing: ^7.4
- symfony/security-core: ^7.4
- symfony/security-csrf: ^7.4
- symfony/yaml: ^7.4
Requires (Dev)
- ibexa/fieldtype-matrix: ^5.0
- ibexa/fieldtype-richtext: ^5.0
- ibexa/graphql: ^5.0
- novactive/ezseobundle: ^8.0
- phpstan/phpstan: ^2.1
- phpunit/phpunit: ^11.5
Suggests
- ibexa/fieldtype-matrix: Reads and writes matrix fields
- ibexa/fieldtype-richtext: Reads and writes rich text fields
- ibexa/graphql: Reads Markdown for rich text fields with its converter
- masilia/ibexa-ai-craft: The assistant builds sites and pages with the blocks of a theme
- masilia/ibexa-ai-editor: AI help in the content editing form (a suggestion per field, image generation)
- novactive/ezseobundle: Reads and writes the SEO metas field (novaseometas)
Provides
None
Conflicts
None
Replaces
None
README
The AI assistant for Ibexa 5: a registry of capabilities that mirror the admin, a chat for editors, an approval flow, and one AI provider per siteaccess.
masilia/ibexa-ai is part of a family of packages for Ibexa that work together or alone. See the other packages.
What it is
An AI assistant for the Ibexa admin, built on Neuron AI (v4). Instead of a few hard-coded tools, it gives the model a registry of capabilities that mirror what the Ibexa admin does — with the same rules — so an editor can ask in plain language and approve each change.
Features
- Capabilities: more than a hundred, grouped in domains (content, trash, structure, URLs, relations, users and roles…). Each is a Neuron tool, found by the model with
tool_search, checked with Ibexa's own rules before it runs. - Risk tiers and approval: every capability is
read,write,destructiveoraccess. Anything that changes something shows an approval card with a preview;propose_changesgroups a batch. What the user's role does not allow is refused before the card. - Audit: what the assistant did, for whom, and with what result.
- A chat in the admin (a floating widget built with assistant-ui over the AG-UI protocol), for everyone whose role has
masilia_ai/use. Conversations are kept and can be renamed or deleted. - Providers per siteaccess: OpenAI, Anthropic, Gemini, Mistral, Ollama, Qwen, Kimi, MiniMax and MiMo, configured in the admin (AI Assistant page), one provider answering for a siteaccess. API keys are encrypted at rest. A fallback
connectioncan be set in configuration. - Two admin pages: AI Assistant (
/ai/settings: engine status, providers and models, usage, siteaccesses) and What the assistant can do (/ai/capabilities: every capability, its risk, what it needs, and whether you can use it). - Extensible: other packages add capabilities, field inputs and skills through the contracts in
Masilia\Contracts\IbexaAi(masilia.ibexa_ai.capabilitytag).masilia/ibexa-ai-craftandmasilia/ibexa-ai-editorare built that way.
Requirements
- PHP 8.3 or later
- Ibexa 5.0 (Symfony 7.4)
- Node.js 24 and Yarn, to build the admin assets with the Ibexa Encore setup of your project
Installed with it by Composer:
masilia/ibexa-admin-kitfor the React components of its admin pages
Works better with (optional):
masilia/ibexa-ai-editorAI suggestions and images in the editing formmasilia/ibexa-ai-craftbuilding sites and pages out of blocks
Installation
composer require masilia/ibexa-ai
-
Enable the bundles in
config/bundles.php:Masilia\Bundle\IbexaAdminKit\MasiliaIbexaAdminKitBundle::class => ['all' => true], Masilia\Bundle\IbexaAi\MasiliaIbexaAiBundle::class => ['all' => true],
-
Import the routes (
config/routes/masilia_ibexa_ai.yaml):masilia_ibexa_ai: resource: '@MasiliaIbexaAiBundle/Resources/config/routes.yaml'
-
Set an encryption key for the API keys and create the tables:
php -r 'echo base64_encode(random_bytes(32));' # put the result in AI_ENCRYPTION_KEY php bin/console doctrine:migrations:migrate
# config/packages/masilia_ibexa_ai.yaml masilia_ibexa_ai: encryption_key: '%env(AI_ENCRYPTION_KEY)%'
Without an explicit key, one is derived from
APP_SECRET: changing the secret would make the stored keys unreadable. If keys were stored before encryption existed, runphp bin/console masilia:ai:encrypt-keys(safe to repeat,--dry-runshows what it would do). -
Build the admin assets and give a role the policies:
yarn ibexa-generate-tsconfig && yarn encore dev # or: yarn encore production
Policy ( masilia_ai)Lets the role… useopen the chat and use read capabilities writeapprove changes to contents destructiveapprove deletions and the like structurechange the content model (types, groups, fields) accessmanage roles, policies and users (off by default) The Administrator role has them all.
Configuration
masilia_ibexa_ai: # A single provider for every siteaccess, when you do not use the admin page connection: provider: openai # openai, anthropic, gemini, mistral, ollama, qwen, kimi, minimax or mimo model: gpt-4o api_key: '%env(OPENAI_API_KEY)%' temperature: 0.7 max_tokens: 4096 os: domains: access: false # roles, policies and users: off until you turn it on encryption_key: '%env(AI_ENCRYPTION_KEY)%'
Usage
Open AI Assistant in the admin, add a provider (a key, an endpoint for local models), pick its chat model and assign it to a siteaccess. Check again tests the engine. Then open the chat from the floating button and ask, for example, "list the children of the home page" or "create a folder called News under the home page" — the second one shows an approval card.
Checks for developers and for your deployments:
php bin/console masilia:ai:os:coverage [--strict] # admin routes that no capability covers php bin/console masilia:ai:os:selftest <locationId> # runs every capability on throwaway folders, then deletes them
Tests
composer install vendor/bin/phpunit vendor/bin/phpstan analyse --memory-limit=2G --no-progress
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— ibexa-ai on Packagist - Archive of a release: GitHub releases (each release lists what changed)
- Source:
git clone https://github.com/MasiliaLabs/ibexa-ai.git - What changed between versions: CHANGELOG.md
Support, contributing and security
- Questions and bug reports: GitHub issues
- 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.