hanwoolderink/ollama-php-client

Ollama php client

v1.0.2 2024-09-06 07:02 UTC

Requires

• php: ^8.3
• guzzlehttp/guzzle: ^7.8
• illuminate/collections: ^11

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.59
• phpstan/phpstan: ^1.11
• phpunit/phpunit: ^11.2
• symfony/var-dumper: ^7.1

MIT

• hanwoolderink

README

PHP client for the Ollama API. It provides a simple way to interact with the API.

See the Ollama API documentation for more information.

Installation

You can install the package via composer:

composer require hanwoolderink/ollama-php-client

Usage

Basic usage example:

use Hanwoolderink\Ollama\Ollama;
use Hanwoolderink\Ollama\Dtos\Message;

$ollama = new Ollama();

$response = $ollama->chat()->create(
  model: 'llama3.1:latest', 
  message: new Message('Why is the sky blue?')
);

echo $response->message->content;

Stream example:

use Hanwoolderink\Ollama\Ollama;
use Hanwoolderink\Ollama\Dtos\Message;

$ollama = new Ollama();

$response = $ollama->chat()->stream(
    model: 'llama3.1:latest',
    messages: [
        new Message('Why does the sky appear more blue in the morning and more red in the evening?')
    ],
);

foreach ($response as $streamResponse) {
    // update storage, socket, etc.. This prints to cli
    $stream = fopen('php://stdout', 'w');
    fwrite($stream, $streamResponse->message->content);
    fclose($stream);
}