Skip to content
Source
Sign inSign up
TanStack/ai

packages/php/tanstack-ai

Contents of packages/php/tanstack-ai
NameLast commit messageLast commit date
..
src (directory)
.gitignore
composer.json
example.php
README.md

README.md

TanStack AI PHP

PHP utilities for converting AI provider events to TanStack AI StreamChunk format and formatting messages between TanStack AI and provider formats.

Installation

composer require tanstack/ai

Or install from source:

cd packages/php/tanstack-ai
composer install

Usage

StreamChunkConverter

Convert provider streaming events to TanStack AI StreamChunk format:

use TanStack\AI\StreamChunkConverter;

$converter = new StreamChunkConverter(
    model: "claude-3-haiku-20240307",
    provider: "anthropic"
);

foreach ($anthropicStream as $event) {
    $chunks = $converter->convertEvent($event);
    foreach ($chunks as $chunk) {
        // Process StreamChunk
    }
}

Message Formatters

Convert TanStack AI messages to provider formats:

use TanStack\AI\MessageFormatters;

// Convert to Anthropic format
[$systemMessage, $anthropicMessages] = MessageFormatters::formatMessagesForAnthropic($messages);

// Convert to OpenAI format
$openaiMessages = MessageFormatters::formatMessagesForOpenAI($messages);

SSE Formatting Utilities

Format StreamChunk arrays as Server-Sent Events (SSE) for HTTP responses:

use TanStack\AI\SSEFormatter;

// Format a chunk
$sseData = SSEFormatter::formatChunk($chunk); // Returns "data: {...}\n\n"

// Format completion marker
$sseDone = SSEFormatter::formatDone(); // Returns "data: [DONE]\n\n"

// Format an error
$sseError = SSEFormatter::formatError($exception); // Returns formatted error chunk

Example usage in Slim Framework:

use TanStack\AI\StreamChunkConverter;
use TanStack\AI\SSEFormatter;

function generateStream($stream, $converter) {
    foreach ($stream as $event) {
        $chunks = $converter->convertEvent($event);
        foreach ($chunks as $chunk) {
            yield SSEFormatter::formatChunk($chunk);
        }
    }
    yield SSEFormatter::formatDone();
}

Supported Providers

  • Anthropic (Claude models)
  • OpenAI (GPT models)

License

MIT