Pi Ollama Extension

Ollama integration for pi-coding-agent with accurate model details from /api/show.

Changelog

v0.4.1

• Fix: Cloud models now correctly use /v1 endpoint. Previously, ollama-cloud was registered with baseUrl: "https://ollama.com", causing pi to hit https://ollama.com/chat/completions (HTML homepage) instead of https://ollama.com/v1/chat/completions. This was already fixed for the local provider but was missed when the cloud provider was introduced.
• Fix: Trailing slashes in cloudUrl config are now properly stripped before appending /v1.

Installation

# Via pi CLI
pi install npm:@0xkobold/pi-ollama

# Or in pi-config.ts
{
  extensions: [
    'npm:@0xkobold/pi-ollama'
  ]
}

# Or temporary (testing)
pi -e npm:@0xkobold/pi-ollama

Features

• 🦙 Local Ollama - Connect to localhost:11434
• ☁️ Ollama Cloud - Use ollama.com with API key
• 📊 Accurate Details - Uses /api/show for real context length
• 👁️ Vision Detection - Detects vision from capabilities array
• 🧠 Reasoning Models - Auto-detects thought-capable models
• 🔍 Model Info - Query specific model parameters

Quick Start

# Check connection
/ollama-status

# List all models (with accurate context length)
/ollama-models

# Get detailed info for specific model
/ollama-info gemma3
/ollama-info llama3.1:70b

Commands

Command	Description
/ollama-status	Check connection status
/ollama-models	List models with context length
/ollama-info MODEL	Show model details from /api/show

How It Works

The extension uses Ollama's /api/show endpoint to get accurate model information:

curl http://localhost:11434/api/show -d '{
  "model": "gemma3",
  "verbose": true
}'

Response includes:

• model_info.context_length - Accurate context window
• capabilities - ["completion", "vision"]
• details.parameter_size - "4.3B", "70B", etc.
• details.family - "gemma3", "llama", etc.

Model Display

Models are displayed with accurate metadata:

📍 Local:
  👁️ gemma3 (4.3B) (131,072 ctx)
  🧠 codellama:70b (70B) (16,384 ctx)
  llama3.1 (8B) (128,000 ctx)

Badges:

• ☁️ Cloud model
• 👁️ Vision-capable
• 🧠 Reasoning-capable

Configuration

Configuration is loaded with the following precedence (highest to lowest):

1. Environment variables (override everything)
2. pi.settings (runtime API, when available)
3. .pi/settings.json (project-local settings)
4. ~/.pi/agent/settings.json (global user settings)

Settings File

Add to your global settings (~/.pi/agent/settings.json):

{
  "ollama": {
    "baseUrl": "http://localhost:11434",
    "cloudUrl": "https://ollama.com",
    "apiKey": "your-ollama-cloud-api-key"
  }
}

Or create project-specific settings (.pi/settings.json in your project root):

{
  "ollama": {
    "baseUrl": "http://custom:11434",
    "apiKey": "project-specific-key"
  }
}

Note: Project settings override global settings.

Environment Variables

export OLLAMA_HOST="http://localhost:11434"
export OLLAMA_HOST_CLOUD="https://ollama.com"
export OLLAMA_API_KEY="your-api-key"

Local Development

git clone https://github.com/0xKobold/pi-ollama
cd pi-ollama
npm install
npm run build
pi install ./

API Functions

import { fetchModelDetails, getContextLength, hasVisionCapability } from '@0xkobold/pi-ollama';

// Get model details
const details = await fetchModelDetails('gemma3', 'http://localhost:11434');

// Extract context length
const ctx = getContextLength(details?.model_info); // 131072

// Check vision support
const hasVision = hasVisionCapability(details); // true

Supported Capabilities

The extension detects:

• Vision: From capabilities array or model_info keys
• Reasoning: From model name (coder, r1, deepseek, think, reason)
• Context Length: From model_info.*.context_length

License

MIT © 0xKobold