PHPackages bold-web/statamic-ai-assistant - 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 & Helpers](/categories/utility) 4. / 5. bold-web/statamic-ai-assistant ActiveLibrary[Utility & Helpers](/categories/utility) bold-web/statamic-ai-assistant ============================== Statamic 6 addon: AI text generation and refactoring in the Control Panel (Ai Text, Bard, DeepL translations). Requires statamic/cms ^6.5. V2.1.3(2mo ago)0333↓13.3%PHP Since May 5Pushed 1w ago2 watchersCompare [ Source](https://github.com/boldwebdev/statamic-ai-assistant)[ Packagist](https://packagist.org/packages/bold-web/statamic-ai-assistant)[ RSS](/packages/bold-web-statamic-ai-assistant/feed)WikiDiscussions main Synced today READMEChangelog (10)Dependencies (9)Versions (17)Used By (0) Statamic Ai Assistant ===================== [](#statamic-ai-assistant) > Control Panel addon for **Statamic 6.5+**: AI text generation and refactoring via custom fieldtypes and Bard, plus optional DeepL translation tools. Requirements ------------ [](#requirements) - **Statamic `^6.5`** (`statamic/cms` is declared in Composer; installs on Statamic 5 will not resolve). - A compatible **Laravel** version for your Statamic release (follow [Statamic’s requirements](https://statamic.dev/installation#requirements)). - **Statamic 5:** use the **`1.x`** release line / branch, not current `main`. Supported API ------------- [](#supported-api) - Infomaniak (CH, respect the data of your clients) - *Default* - Groq (USA, get the speed) - ...more to come Features -------- [](#features) - Allow the usage of 'Ai Textarea' custom component in Statamic - Allow the usage of 'Ai Text' custom component in Statamic - Upgrade Bard by adding the AI asisstant buttons (generation and translation) directly in Bard - Multilang supported (CP panel addon translations in EN/DE/FR/IT for now) How to Install -------------- [](#how-to-install) Install with Composer. Current releases target **Statamic 6.5+**. If you are on **Statamic 5**, require **`^1`** so Composer stays on the compatible major: ``` composer require bold-web/statamic-ai-assistant ``` ``` # Statamic 5 projects only — pin the 1.x line composer require bold-web/statamic-ai-assistant:^1 ``` How to Use ---------- [](#how-to-use) The plugin use per default Infomaniak API, a Swiss solution🇨🇭 respecting the data of your users and the planet. However if you want to switch to a faster generation with a US based company this plugin also comes with Groq API support. ### Infomaniak API [](#infomaniak-api) 1. Create an [Infomaniak](https://manager.infomaniak.com) account and generate an API token with access to your AI Tools. Define it in your `.env` file as `INFOMANIAK_API_TOKEN` 2. Go to your dashboard computing->AI tools and define the `INFOMANIAK_PRODUCT_ID` in your `.env` file (or use their API to get the product id: ) > tips for GET request: Just use postman with your api key in the Authorization header 'Bearer your-api-key' to get the product id ### Groq API [](#groq-api) 1. Create a [groq](https://groq.com/) account and generate an API key. Define it in your `.env` file as `GROQ_API_KEY` 2. Add `STATAMIC_AI_ASSISTANT_PROVIDER_NAME='groq'` in your `.env` file to use groq ### Translations (DeepL) [](#translations-deepl) > **Breaking change:** Translation features (Bard DeepL actions, bulk translation, and related Control Panel tools) **require a DeepL API key**. Add `DEEPL_API_KEY` to your `.env` as described below. If you upgrade from an older release, configure DeepL or turn translations off with `STATAMIC_AI_ASSISTANT_TRANSLATIONS=false`. Bulk translation, Bard field translation, and related CP tools use **DeepL** (not the LLM provider above). 1. Create a [DeepL API](https://www.deepl.com/pro-api) account and copy your API authentication key. 2. Add it to your application `.env` file: ``` DEEPL_API_KEY=your-deepl-api-key-here ``` 3. After installing or updating the addon, publish config if you need to customize language mapping or English/Portuguese variants: ``` php artisan vendor:publish --tag=statamic-ai-assistant --force ``` The key is read from `config/deepl.php` (`DEEPL_API_KEY`). Optional overrides in `.env` (see `config/deepl.php` after publishing): ``` # Optional: DeepL requires en-GB / en-US (not bare "en") for some targets DEEPL_ENGLISH_TARGET=en-GB DEEPL_PORTUGUESE_TARGET=pt-PT ``` You can disable translation features entirely with: ``` STATAMIC_AI_ASSISTANT_TRANSLATIONS=false ``` #### Linked entries depth (admin-only) [](#linked-entries-depth-admin-only) When an entry references other entries (entries/link fields, Bard entry links, nested replicator data), the translator can **recursively** create or update localized siblings so IDs point to the correct language. **Editors do not choose this in the UI** — it is controlled by configuration. - **Default:** `1` — one “hop”: linked entries directly used by the page are translated when needed; links inside those entries are not followed further. - **Override:** set an integer from 0 to **5** in `.env`: ``` # Optional. Default is 1. Use 0 to only remap IDs when a translation already exists. STATAMIC_AI_ASSISTANT_LINKED_ENTRIES_MAX_DEPTH=1 ``` Higher values increase DeepL usage and runtime (more entries may be created in one run). See `config/statamic-ai-assistant.php` (`linked_entries_max_depth`) for the full comment block. ### Customization in your .env file [](#customization-in-your-env-file) - You can override GROQ\_MODEL with [the available model you want to use](https://console.groq.com/docs/models) / default is llama-3.1-8b-instant - You can override INFOMANIAK\_MODEL with [the available model you want to use](https://www.infomaniak.com/fr/hebergement/ai-tools/open-source-models) / default is mistral24b - You can override STATAMIC\_AI\_ASSISTANT\_PREFACE for your custom needs. > default preface of the addon: 'You are a seasoned SEO expert who writes clear, professional, seo friendly and engaging articles in plain text. Your task is to produce fully readable articles for an end user. Do not include any markdown formatting, HTML tags, header tags, meta descriptions, or any other markup. Write only the final article text in plain text, ensuring it is clear, direct, and free of extraneous formatting elements.' - you can override STATAMIC\_AI\_ASSISTANT\_REFACTOR\_PREFACE > default refactor preface of the addon: 'You are a professional text refactoring expert. Your only task is to transform the provided text according to the specific instructions given by the user. Output solely the final refactored text in plain text, DO NOT INCLUDE the user instructions, any commentary, or any additional text. Preserve the original language and maintain a similar length to the input text unless instructed otherwise.' - you can override STATAMIC\_AI\_ASSISTANT\_HTML\_REFACTOR\_PREFACE > default refactor preface of the addon: 'You are a professional text refactoring expert. Your only task is to transform the provided HTML text according to the specific instructions given by the user. Output solely the final refactored HTML! DO NOT INCLUDE the user instructions, any commentary, or any additional text. ALWAYS RENDER the output as valid HTML. Keep all links intact unless the user specifically instructs you to modify them, and always strive to preserve the original HTML structure unless instructed otherwise.ALWAYS update lorem ipsum. Preserve the original language and maintain a similar length to the input text unless otherwise specified.' - You can override TEMPERATURE - You can override MAX\_TOKENS - You can disable the translation functionality with `STATAMIC_AI_ASSISTANT_TRANSLATIONS=false` - DeepL translation requires `DEEPL_API_KEY` in `.env` (see **Translations (DeepL)** above) Upgrade Request --------------- [](#upgrade-request) If you face issues or have improvements ideas do not hesitate to send us an email at . We’ll read all emails, but please understand that this package is maintained as a side project for us, so we may not get back to you directly. Thank you for your understanding ❤️ ### Health Score 43 — FairBetter than 89% of packages Maintenance92 Actively maintained with recent releases Popularity15 Limited adoption so far Community8 Small or concentrated contributor base Maturity46 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 ~23 days Recently: every ~0 days Total 16 Last Release 79d ago Major Versions v1.1-beta → v2.02026-04-08 1.x-dev → V2.1.32026-04-15 ### Community Maintainers ![](https://www.gravatar.com/avatar/95552057e5a552d53af09b4e24b37f0a3da007ca1b83f19cc50f6ec4bdf66ccb?d=identicon)[boldwebdev](/maintainers/boldwebdev) --- Top Contributors [![anthonycherbuin](https://avatars.githubusercontent.com/u/16646440?v=4)](https://github.com/anthonycherbuin "anthonycherbuin (5 commits)") --- Tags aistatamicdeeplbardstatamic-6 ### Embed Badge ![Health badge](/badges/bold-web-statamic-ai-assistant/health.svg) ``` [![Health](https://phpackages.com/badges/bold-web-statamic-ai-assistant/health.svg)](https://phpackages.com/packages/bold-web-statamic-ai-assistant) ``` ### Alternatives [statamic/seo-pro 68516.6k](/packages/statamic-seo-pro)[visuellverstehen/statamic-classify A useful helper to add CSS classes to all HTML tags generated by the bard editor. 20121.3k](/packages/visuellverstehen-statamic-classify)[marcorieser/statamic-livewire A Laravel Livewire integration for Statamic. 23111.5k15](/packages/marcorieser-statamic-livewire)[withcandour/aardvark-seo Save time and get your Statamic site to rank better with the SEO addon for Statamic. 15133.0k](/packages/withcandour-aardvark-seo)[aerni/livewire-forms A Statamic forms framework powered by Laravel Livewire 2915.1k](/packages/aerni-livewire-forms)[mitydigital/feedamic A fully-featured RSS and Atom feed generator for Statamic. 1075.6k](/packages/mitydigital-feedamic) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)