Getting Started

Requirements

• PHP >= 8.4
• CakePHP ^5.4

Installation

composer require crustum/cakephp-ai

Configuration

Copy the default config to config/ai.php. The top-level key is Ai:

return [
    'Ai' => [
        // Environment: AI_DEFAULT_PROVIDER, default 'openrouter'
        'defaultProvider' => 'openrouter',
    ],
];

The default provider is OpenRouter. Per-capability defaults ship in the same file:

Capability	Default
Images, audio, transcription, embeddings, reranking	openrouter
Classification	typesafe
Stores, files	openai

Each provider entry carries its credentials and timeouts (key/apiKey, url/baseUrl, timeout, models). Provider-specific keys exist where the API demands them: Azure deployments, Bedrock region and credentials, the Anthropic version header.

Next steps

• Providers — the 17 providers behind one interface
• Agents — prompt, stream, remember, delegate