Content AI Bundle

AI-powered content assistant for Sulu CMS 3.x

Bring generative AI to your Sulu content, straight from the admin:
generate and rewrite page/article blocks, a per-field writing assistant, automated SEO metadata,
image metadata from vision, metadata translation, and reusable AI experts & prompts.

Your own provider keys (OpenAI, Mistral, Anthropic), used directly — no SaaS in between.

⚠️ Work in progress. This bundle is under active development. The public API and configuration may still change before 1.0.

Requirements

• PHP >= 8.2 (with the bundled sodium extension, used to encrypt provider keys)
• Sulu CMS >= 3.0
• Symfony >= 7.0
• Doctrine ORM >= 3.0
• symfony/ai platform bridges ~0.10 (OpenAI, Mistral and/or Anthropic)

Features

• In-admin AI assistant — a toolbar button on the page/article form opens a chat panel that can generate content (filling the document's blocks via structured output constrained to your templates) and transform existing content in place (translate, rephrase, shorten…) with natural-language targeting.
• Per-field writing assistant — an AI button overlaid on each text field opens a stateless Writing Assistant (selected text + an expert + a predefined prompt + a free instruction) that rewrites just that field, in its locale.
• Automated SEO metadata — a Generate SEO tags button on the SEO tab fills title, description and keywords from the page content.
• Media metadata — on the media form, Generate metadata describes an image with a vision model (title + alt-text), and Translate metadata translates the media metadata from one locale to another.
• AI experts & predefined prompts — admin CRUD (under Settings → AI Assistant) to manage reusable experts (personas / brand voice) and predefined prompts, used by the writing assistant.
• Provider configuration in the admin — manage providers and API keys from the admin. Keys are encrypted at rest; the active provider is resolved dynamically, with a fallback to your .env configuration.
• Multi-provider & locale-aware — OpenAI, Mistral, Anthropic. Output always follows the content locale, and a shared style guidance avoids the usual "AI tells" (em dashes, emojis, clichés).

Installation

1. Require the bundle

2. Register the bundle

If Symfony Flex does not do it automatically:

3. Register the routes

4. Configure the AI providers

The bundle consumes the symfony/ai platforms. Declare the providers you use and keep the keys in the environment:

You can also configure providers from the admin (Settings → AI Assistant → Providers), where the key is stored encrypted. When a provider is configured there, it takes precedence over the .env fallback.

5. Register the admin assets

Edit assets/admin/package.json to add the bundle to the dependencies:

Edit assets/admin/app.js to import the bundle:

In the assets/admin/ folder, install and rebuild the admin assets:

6. Update the database schema

7. Clear the cache

Configuration

The bundle exposes a minimal configuration under the itech_world_sulu_content_ai key:

See doc/configuration.md for the full setup (agent configuration, per-field button positioning, etc.).

Usage

Everything happens from the Sulu admin:

• Pages / articles — the AI Assistant toolbar button (chat) and the per-field AI button on text fields.
• SEO tab — the Generate SEO tags button.
• Media — the Generate metadata (vision) and Translate metadata buttons.
• Settings → AI Assistant — manage Experts, Prompts and Providers (API keys, models).

The generated content is inserted into the form as unsaved changes: review it, then save (or discard) as usual.

Architecture

Available translations

• English
• French
• German

🐛 Bug and Idea

See the open issues for a list of proposed features (and known issues).

💰 Support me

You can buy me a coffee to support me — this bundle is 100% free.

Buy me a coffee

👨‍💻 Contact

📘  License

This bundle is under the MIT License.