knackline / laravel-olm

dev-main 2026-09-09 14:47 UTC

Requires

• php: ^8.1
• illuminate/http: ^9.0|^10.0|^11.0|^12.0
• illuminate/support: ^9.0|^10.0|^11.0|^12.0

Requires (Dev)

• mockery/mockery: ^1.4
• orchestra/testbench: ^7.0|^8.0|^9.0|^10.0
• phpunit/phpunit: ^9.0|^10.0|^11.0

MIT

• Rajkumar Samra

• laravel
• llm
• llama.cpp
• ollama
• lm-studio
• local-ai
• openai-compatible
• vllm
• on-device
• mlx

Published on Packagist.org on 2026-09-09 14:47 UTC

README

OLM (On-device Language Models) is a Laravel connector for local / on-device LLM backends: MLX, Ollama, LM Studio, llama.cpp, and vLLM.

Use one API in your Laravel app — switch backends with config.

Features

• Unified chat, completions, embeddings, and streaming
• Driver pattern (Olm::driver('mlx')) like Laravel filesystem/mail
• OpenAI-compatible HTTP for MLX, LM Studio, llama.cpp, and vLLM
• Ollama native model list / pull / show
• Publishable config and facade helper

Requirements

• PHP 8.1+
• Laravel 9.x–12.x
• A running local inference server for the driver you choose

Installation

composer require knackline/laravel-olm

Publish the config:

php artisan vendor:publish --provider="Knackline\Olm\Providers\OlmServiceProvider" --tag="olm-config"

Configuration

.env examples:

OLM_DRIVER=ollama

OLM_OLLAMA_BASE_URL=http://127.0.0.1:11434
OLM_OLLAMA_MODEL=llama3.2

OLM_MLX_BASE_URL=http://127.0.0.1:8080
OLM_MLX_MODEL=mlx-community/Mistral-7B-Instruct-v0.3-4bit

OLM_LMSTUDIO_BASE_URL=http://127.0.0.1:1234
OLM_LMSTUDIO_MODEL=local-model

OLM_LLAMACPP_BASE_URL=http://127.0.0.1:8080
OLM_VLLM_BASE_URL=http://127.0.0.1:8000

Backend setup

Ollama

Install Ollama, then:

ollama pull llama3.2

MLX (Apple Silicon)

pip install mlx-lm
mlx_lm.server --model mlx-community/Mistral-7B-Instruct-v0.3-4bit

Default listen address is typically http://127.0.0.1:8080.

LM Studio

Start the local server in LM Studio (OpenAI-compatible API), usually http://127.0.0.1:1234.

llama.cpp

Run llama-server with an OpenAI-compatible HTTP API, e.g. port 8080.

vLLM

vllm serve <model> --host 127.0.0.1 --port 8000

Usage

Facade

use Knackline\Olm\Facades\Olm;

$response = Olm::chat([
    ['role' => 'user', 'content' => 'Hello!'],
]);

echo $response->content;

// Another backend
$response = Olm::driver('mlx')->chat([
    ['role' => 'user', 'content' => 'Hello from MLX'],
], [
    'temperature' => 0.7,
]);

Helper

olm()->chat([
    ['role' => 'user', 'content' => 'Summarize this…'],
]);

olm('vllm')->embed('search query');

Streaming

foreach (Olm::streamChat([
    ['role' => 'user', 'content' => 'Write a haiku'],
]) as $token) {
    echo $token;
}

Embeddings & completions

$embedding = Olm::embed('hello world');
$vector = $embedding->first();

$completion = Olm::complete('Once upon a time');

Models & Ollama pull

$models = Olm::models();

// Ollama only
Olm::driver('ollama')->pull('llama3.2');
$info = Olm::driver('ollama')->show('llama3.2');

Calling pull / show on drivers that do not support them throws UnsupportedOperationException.

Dependency injection

use Knackline\Olm\OlmManager;

class ChatController
{
    public function __construct(protected OlmManager $olm)
    {
    }

    public function __invoke()
    {
        return $this->olm->chat([
            ['role' => 'user', 'content' => 'Hi'],
        ]);
    }
}

Roadmap

• Fine-tuning helpers / job stubs
• Richer multimodal (vision / audio) support
• Optional integrations (Laravel AI, Prism, etc.)

Testing

composer install
composer test

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.