fomvasss/laravel-ai-tasks

Orchestrator AI-tasks for Laravel: drivers, routing, queue, ai_runs, post-processing

dev-master 2025-10-24 18:19 UTC

Requires

• php: ^8.1
• guzzlehttp/guzzle: ^7.8
• illuminate/contracts: ^10.0|^11.0|^12.0
• illuminate/database: ^10.0|^11.0|^12.0
• illuminate/events: ^10.0|^11.0|^12.0
• illuminate/http: ^10.0|^11.0|^12.0
• illuminate/pipeline: ^10.0|^11.0|^12.0
• illuminate/queue: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0

MIT

• fomvasss

• queue
• laravel
• ai
• orchestrator
• Gemini
• openai
• llm

README

Orchestrator AI-tasks for Laravel: drivers, routing, queue, ai_runs, post-processing.

Installation

Install the package via composer:

composer require fomvasss/laravel-ai-tasks

Publish and run the migrations with:

php artisan vendor:publish --provider="Fomvasss\AiTasks\AiServiceProvider" --tag=config
php artisan vendor:publish --provider="Fomvasss\AiTasks\AiServiceProvider" --tag=migrations
php artisan migrate

Example .env:

QUEUE_CONNECTION=redis

OPENAI_API_KEY=...
GEMINI_API_KEY=...

Usage

<?php

use Fomvasss\AiTasks\Facades\AI;
use Fomvasss\AiTasks\Tasks\GenerateProductDescription;

// sync
$result = AI::send(new GenerateProductDescription((object)[
  'title' => 'Samsung S25 Plus',
  'features' => ['Mint', 'USB-C', '512GB'],
]));

// async
AI::queue(new GenerateProductDescription((object)['title'=>'MacBook Pro','features'=>[]]));

To perform async tasks and process webhooks, queues with names as specified in the configuration file must be launched ai.php section queues.

Usage queue in tasks

<?php

class GenerateProductDescription extends AiTask implements ShouldQueueAi {

  use QueueableAi;

  public function viaQueues(): array { return ['request'=>'ai:low','postprocess'=>'ai:post']; }
}

Configure routings

'routing' => [
  'product_description' => ['gemini','openai'],
]

Task generator

Make new task:

php artisan ai:make-task GenerateSeoMeta --queued --modality=text --namespace=App\\Ai\\Tasks

Params:

    name — base name (sufix Task added automaticly).
    --queued — added ShouldQueueAi + QueueableAi and method viaQueues().
    --modality= — text|chat|image|vision|embed (default text).
    --namespace=App\\Ai\\Tasks — place file (default: App\Ai\Tasks).
    --force — rewrite the file if it exists.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• fomvasss

License

The MIT License (MIT). Please see License File for more information.