PHPackages                             evolution-cms/eai - 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. evolution-cms/eai

ActiveEvolutioncms-plugin[Utility & Helpers](/categories/utility)

evolution-cms/eai
=================

Laravel AI SDK integration for Evolution CMS

121↓50%PHP

Since Feb 10Pushed 3mo agoCompare

[ Source](https://github.com/evolution-cms/eAi)[ Packagist](https://packagist.org/packages/evolution-cms/eai)[ RSS](/packages/evolution-cms-eai/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

[![Total Downloads](https://camo.githubusercontent.com/a3b58c7762ff57ff3b087ebf9f92c09b47856f8f10e93ad5053624847fd27ba7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f65766f6c7574696f6e2d636d732f656169)](https://packagist.org/packages/evolution-cms/eai)[![Latest Stable Version](https://camo.githubusercontent.com/e253a3185e7b3755c531e14167ba917fd6e4b5d845febcf9858b5545694d71eb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f65766f6c7574696f6e2d636d732f656169)](https://packagist.org/packages/evolution-cms/eai)[![License](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)

eAi for Evolution CMS
=====================

[](#eai-for-evolution-cms)

eAi is the Evolution CMS integration layer for the Laravel AI SDK. It provides Evo‑native config publishing, minimal shims for missing `Illuminate\Foundation` classes, and an sTask‑first queue bridge.

If you only need a quick start and examples, use this README. For full details see `DOCS.md` (EN) or `DOCS.uk.md` (UA).

Requirements
------------

[](#requirements)

- Evolution CMS 3.5.2+
- PHP 8.4+
- Composer 2.2+

Optional:

- sTask for async tasks (currently `dev-main` from the main repo)

Quick Start
-----------

[](#quick-start)

From your Evo `core` directory:

```
cd core
php artisan package:installrequire evolution-cms/eai "*"
php artisan migrate
```

Publish configs and stubs (optional, auto‑publish is enabled):

```
php artisan vendor:publish --provider="EvolutionCMS\\eAi\\eAiServiceProvider" --tag=eai-config
php artisan vendor:publish --provider="EvolutionCMS\\eAi\\eAiServiceProvider" --tag=eai-ai-config
php artisan vendor:publish --provider="EvolutionCMS\\eAi\\eAiServiceProvider" --tag=eai-stubs
```

Set provider key in `.env` or `core/custom/config/ai.php`:

```
OPENAI_API_KEY=...

```

Run the built‑in smoke test:

```
php artisan ai:test
```

For local Ollama:

```
php artisan ai:test --provider=ollama
```

Minimal Usage
-------------

[](#minimal-usage)

```
use App\Ai\Agents\SupportAgent;

$agent = new SupportAgent();
$response = $agent->prompt('Hello from Evo');

echo $response->text;
```

Queues (sTask‑first)
--------------------

[](#queues-staskfirst)

- sTask is the primary backend; `sync` is a fallback.
- eAi does not implement Laravel Queue; it only provides SDK‑compatible dispatching.

Process queued tasks:

```
php artisan stask:worker
```

sTask UI workers (for testing):

- `eai_smoke` — fixed prompt
- `eai_prompt` — custom prompt from widget

AI Service Account (Role‑based)
-------------------------------

[](#ai-service-account-rolebased)

AI runs as a normal manager user with role **AI** (auto‑created). The role is read‑only by default; to allow saving/publishing, elevate permissions manually (e.g. Publisher).

Example settings in `core/custom/config/cms/settings/eAi.php`:

```
ai_actor_mode: service
ai_actor_email: ai@your-host
ai_actor_autocreate: true
ai_actor_block_login: true
ai_actor_role: AI
ai_actor_role_autocreate: true

```

If you need access to package interfaces, grant permissions `stask` and/or `sapi` to the **AI** role (grouped under `sPackages`).

Artisan Generators
------------------

[](#artisan-generators)

```
php artisan make:agent SalesCoach
php artisan make:agent SalesCoach --structured
php artisan make:tool RandomNumberGenerator
```

Generated classes are placed in `core/custom/app/Ai/...`. If autoloading is not updated, run `composer dumpautoload`.

More Details
------------

[](#more-details)

See `DOCS.md` for full configuration reference, identity rules, queue contract, and advanced SDK usage.

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance55

Moderate activity, may be stable

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/9a722445bb0bad50ab37fec12236f407434df04d5b7b9051bdb26336758e209e?d=identicon)[dmi3yy](/maintainers/dmi3yy)

---

Top Contributors

[![Dmi3yy](https://avatars.githubusercontent.com/u/669491?v=4)](https://github.com/Dmi3yy "Dmi3yy (14 commits)")

### Embed Badge

![Health badge](/badges/evolution-cms-eai/health.svg)

```
[![Health](https://phpackages.com/badges/evolution-cms-eai/health.svg)](https://phpackages.com/packages/evolution-cms-eai)
```

###  Alternatives

[sybrew/the-seo-framework-extension-manager

A WordPress plugin that allows you to manage extensions for The SEO Framework.

8490.3k](/packages/sybrew-the-seo-framework-extension-manager)[branchonline/yii2-lightbox

Lightbox widget for Yii2

13139.0k1](/packages/branchonline-yii2-lightbox)

PHPackages © 2026

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