akumi-cloud/sdk

Official PHP SDK for the Akumi EU-sovereign inference API.

v0.1.0 2026-07-23 17:14 UTC

Requires

• php: ^8.2
• php-http/discovery: ^1.19
• psr/http-client: ^1.0
• psr/http-factory: ^1.0
• psr/http-message: ^2.0

Requires (Dev)

• guzzlehttp/guzzle: ^7.8
• illuminate/support: ^11.0|^12.0
• laravel/pint: ^1.18
• phpstan/phpstan: ^1.12
• phpunit/phpunit: ^11.0

Suggests

• guzzlehttp/guzzle: A PSR-18 HTTP client implementation
• illuminate/support: For the optional Laravel service provider

MIT

Published on Packagist.org on 2026-07-23 21:53 UTC

README

The official PHP client for Akumi, the EU-sovereign, OpenAI-compatible inference API. One base_url for every model, governed and metered, with your regulated data kept in the EU.

• Drop-in OpenAI-compatible. Chat completions, embeddings, and models under one key.
• EU-sovereign by default. Requests run on EU-resident models unless you explicitly allow otherwise; the egress guard fails closed.
• Governed, not just hosted. PII firewall, per-request residency, and a metadata-only audit trail come with every call.
• Dependable. Streaming responses and automatic retries on transient errors.

Requirements

PHP 8.2 or newer.

Install

composer require akumi-cloud/sdk

Quickstart

Create an API key under app.akumi.cloud -> Platform -> API keys, then:

use Akumi\Sdk\Akumi;

$akumi = Akumi::fromApiKey('mk_...');

$response = $akumi->chat->create([
    'model' => 'mistral/mistral-large-latest',
    'messages' => [
        ['role' => 'user', 'content' => 'Explain EU data residency in one sentence.'],
    ],
]);

echo $response['choices'][0]['message']['content'];

Streaming

createStreamed() returns a generator of OpenAI-compatible chunks:

foreach ($akumi->chat->createStreamed([
    'model' => 'mistral/mistral-large-latest',
    'messages' => [['role' => 'user', 'content' => 'Write a haiku about Frankfurt.']],
]) as $chunk) {
    echo $chunk['choices'][0]['delta']['content'] ?? '';
}

Embeddings

$embeddings = $akumi->embeddings->create([
    'model' => 'mistral/mistral-embed',
    'input' => 'The quarterly report is ready for review.',
]);

$vector = $embeddings['data'][0]['embedding'];

More resources

Resource	Call
List available models	$akumi->models->list()
Long-term memory	$akumi->memory->forget([...])
Conversation threads	$akumi->memoryThreads->list()
Audit logs	$akumi->auditLogs->list()

Configuration

fromApiKey() connects to https://api.akumi.cloud/v1 and retries transient failures (429, 502, 503, 504) automatically. Pass a base URL to target another host.

Documentation

• Guides: https://akumi.cloud/docs
• API reference: https://akumi.cloud/docs/api-reference

About

This SDK is generated from the Akumi OpenAPI specification, so it tracks the API automatically. Found a bug? Open an issue at https://github.com/akumi-cloud/php-sdk.

MIT licensed.