Search by

papi-ai / ollama

md

Ollama (local) provider for PapiAI

Package info

github.com/papi-ai/ollama

Type:papi-provider

pkg:composer/papi-ai/ollama

Statistics

Installs: 27

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v0.16.2 2026-11-16 20:40 UTC

README

CI Latest Version Total Downloads PHP Version License

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

Installation

composer require papi-ai/ollama

Usage

use PapiAI\Core\Agent;
use PapiAI\Ollama\OllamaProvider;

$provider = new OllamaProvider();

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

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

Available Models

The following models are supported (as referenced in OllamaProvider):

Model Type
llama3.1 General purpose
codellama Code generation
mistral General purpose
mixtral Mixture of experts
qwen2.5-coder Code generation
nomic-embed-text Embeddings (default)

Features

  • Tool/function calling
  • Streaming support
  • Embeddings support
  • Vision support
  • Structured output / JSON mode
  • Runs locally via Ollama (no API key required)

Creating It by Name

An application that picks its provider from configuration can build this one without naming its class:

use PapiAI\Core\Factory\ComposerDiscovery;
use PapiAI\Core\Factory\ProviderRegistry;

$registry = new ProviderRegistry(new ComposerDiscovery());

$provider = $registry->create('ollama', [
    'model' => 'llama3.1',
]);

It takes base_url, model, max_tokens and effort. Anything it is not given falls back to the constructor's defaults, and a missing or unknown setting throws ConfigurationException before any request is made.

License

MIT