Installation
Installation
Install the official Laravel AI SDK and this provider package:
composer require laravel/ai
composer require padosoft/laravel-ai-regolo
The service provider is auto-discovered through Composer:
{
"extra": {
"laravel": {
"providers": [
"Padosoft\\LaravelAiRegolo\\LaravelAiRegoloServiceProvider"
]
}
}
}
Requirements
| Dependency | Supported range |
|---|---|
| PHP | ^8.3 |
| Laravel components | ^12.0 or ^13.0 |
| Laravel AI SDK | ^0.6|^0.7|^0.8 |
Laravel 11 is not supported because the upstream laravel/ai SDK requires Laravel 12 or newer components.
Publish or edit AI configuration
Publish config/ai.php from laravel/ai if your application does not already have it, then add a regolo provider entry. The package registers the regolo driver name.
'regolo' => [
'driver' => 'regolo',
'name' => 'regolo',
'key' => env('REGOLO_API_KEY'),
'url' => env('REGOLO_BASE_URL', 'https://api.regolo.ai/v1'),
'timeout' => 60,
'models' => [
'text' => [
'default' => 'Llama-3.1-8B-Instruct',
'cheapest' => 'Llama-3.1-8B-Instruct',
'smartest' => 'Llama-3.3-70B-Instruct',
],
'embeddings' => [
'default' => 'Qwen3-Embedding-8B',
'dimensions' => 4096,
],
'reranking' => [
'default' => 'Qwen3-Reranker-4B',
],
'image' => [
'default' => env('REGOLO_IMAGE_MODEL', 'Qwen-Image'),
],
'transcription' => [
'default' => env('REGOLO_TRANSCRIPTION_MODEL', 'faster-whisper-large-v3'),
],
'audio' => [
'default' => env('REGOLO_AUDIO_MODEL'),
],
],
],
Environment
REGOLO_API_KEY=rg_live_...
REGOLO_BASE_URL=https://api.regolo.ai/v1
AI_DEFAULT_TEXT=regolo
AI_DEFAULT_EMBEDDINGS=regolo
AI_DEFAULT_RERANKING=regolo
Keep REGOLO_BASE_URL optional in production unless Seeweb gives you a staging or dedicated endpoint.