papi-ai/grok

Grok (xAI) provider for PapiAI

v0.15.2 2026-07-31 18:02 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-08-01 09:28 UTC

README

Grok (xAI) provider for PapiAI - A simple but powerful PHP library for building AI agents.

Installation

composer require papi-ai/grok

Usage

use PapiAI\Core\Agent;
use PapiAI\Grok\GrokProvider;

$provider = new GrokProvider(
    apiKey: $_ENV['XAI_API_KEY'],
);

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

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

Available Models

GrokProvider::MODEL_GROK_4_5  // 'grok-4.5' (default)
GrokProvider::MODEL_GROK_4_3  // 'grok-4.3'

The MODEL_GROK_2, MODEL_GROK_3 and MODEL_GROK_3_MINI constants are still shipped but deprecated. Grok 2 is retired, and the Grok 3 pair was retired on 15 May 2026: requests silently redirect to grok-4.3 and bill at its rates, so pin a live model explicitly.

Features

• Tool/function calling
• Vision/multimodal support
• Structured output (JSON mode)
• Streaming support

License

MIT