papi-ai / cohere

v0.16.0 2026-09-14 19:38 UTC

Requires

• php: ^8.2
• ext-curl: *
• papi-ai/papi-core: ^0.15

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• pestphp/pest: ^3.0
• vimeo/psalm: ^6.0

MIT

• Marcello Duarte

Published on Packagist.org on 2026-09-14 20:06 UTC

README

Cohere provider for PapiAI - A simple but powerful PHP library for building AI agents.

Installation

composer require papi-ai/cohere

Usage

use PapiAI\Core\Agent;
use PapiAI\Cohere\CohereProvider;

$provider = new CohereProvider(
    apiKey: $_ENV['COHERE_API_KEY'],
);

$agent = new Agent(
    provider: $provider,
    instructions: 'You are a helpful assistant.',
);

$response = $agent->run('Hello!');
echo $response->text;

Available Models

Chat Models

CohereProvider::MODEL_COMMAND_A_PLUS      // 'command-a-plus-05-2026' (default)
CohereProvider::MODEL_COMMAND_A           // 'command-a-03-2025'
CohereProvider::MODEL_COMMAND_A_REASONING // 'command-a-reasoning-08-2025'
CohereProvider::MODEL_COMMAND_R7B         // 'command-r7b-12-2024'

The MODEL_COMMAND, MODEL_COMMAND_R and MODEL_COMMAND_R_PLUS constants are still shipped but deprecated: all three were deprecated on 15 September 2025, and the two oldest predate command-r7b, so they reject forced tool choice.

Embedding Models

CohereProvider::MODEL_EMBED_V4            // 'embed-v4.0'
CohereProvider::MODEL_EMBED_ENGLISH       // 'embed-english-v3.0'
CohereProvider::MODEL_EMBED_MULTILINGUAL  // 'embed-multilingual-v3.0'

Features

• Chat completions via Cohere v2 API
• Tool/function calling
• Streaming support
• Text embeddings

License

MIT