Ollama Provider

@namzu/ollama is the local-first provider package for an Ollama daemon. It is a direct fit when your Namzu runtime should stay close to locally hosted open models.

1. When to Use It

Choose this package when Ollama is the runtime you actually want to operate, not just an endpoint you happen to expose over a compatible HTTP interface.

2. When Not to Use It

Choose another provider when:

• you only need the OpenAI-compatible Ollama endpoint and want the most generic abstraction, where @namzu/http may be enough
• your local workflow is based on LM Studio rather than Ollama

3. Install

pnpm add @namzu/sdk @namzu/ollama

4. Prerequisites

Before using the provider:

• run the Ollama daemon
• pull the model you plan to use
• confirm the host if not using the default

5. Register and Create the Provider

import { ProviderRegistry } from '@namzu/sdk'
import { registerOllama } from '@namzu/ollama'
 
registerOllama()
 
const { provider, capabilities } = ProviderRegistry.create({
  type: 'ollama',
  host: 'http://localhost:11434',
  model: 'llama3.2',
})

6. Sanity-Check With a Direct Provider Call

const response = await provider.chat({
  model: 'llama3.2',
  messages: [{ role: 'user', content: 'Say hello in one sentence.' }],
})
 
console.log(response.message.content)

7. Configuration

8. Capability Snapshot

The package exports OLLAMA_CAPABILITIES:

{
  supportsTools: false,
  supportsStreaming: true,
  supportsFunctionCalling: false,
}

That conservative declaration is intentional. Actual tool support varies by model and should not be assumed globally.

9. Operational Notes

• An Ollama daemon and at least one pulled model must already be available.
• The exported OLLAMA_CAPABILITIES constant is conservative and reports tool support as false by default because tool behavior depends on the chosen model.
• If you prefer a generic OpenAI-compatible path over the Ollama-specific package, @namzu/http can target the Ollama HTTP endpoint instead.
• The provider also implements listModels() and healthCheck().

10. Common Errors

Related

• Providers Overview
• Provider Selection Guide
• HTTP Provider
• Provider Registry
• Ollama Provider Entry
• Ollama Config Types