ollama-models

TypeScript/JavaScript client for searching and listing models from the Ollama registry.

Installation

npm install ollama-models
# or
pnpm add ollama-models

Usage

import { OllamaModelsClient } from 'ollama-models';

// No base URL needed — defaults to the official hosted instance
const client = new OllamaModelsClient();

// Pass a base URL only if you self-host the API
// const client = new OllamaModelsClient('https://your-own-instance.workers.dev');

// Search models
const result = await client.search('qwen3', 1);
result.pages.forEach(p => console.log(p.http_url));

// Get all tags for a model
const model = await client.getModel('qwen3');
console.log(model.default_tag); // qwen3:latest
model.tags.forEach(t => console.log(t));

API

new OllamaModelsClient(baseUrl?)

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | baseUrl | string | https://ollama.devcomfort.me/api | Base URL of the ollama-models Workers API |

client.search(keyword?, page?): Promise<SearchResult>

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | keyword | string | "" | Search term | | page | number | 1 | Page number (1-based) |

client.getModel(name): Promise<ModelTags>

| Parameter | Type | Description | |-----------|------|-------------| | name | string | Model identifier (qwen3, library/qwen3, User/model, or full URL) |

Types

interface SearchResult {
  pages: ModelPage[];
  page_id: number;
  keyword: string;
}

interface ModelTags {
  page_url: string;
  id: string;           // e.g. "library/qwen3"
  tags: string[];       // e.g. ["qwen3:latest", "qwen3:4b"]
  default_tag: string | null;
}

interface ModelPage {
  http_url: string;
}