---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/embeddings/ollama/adapter/classes/OllamaEmbeddingsAdapter.md
description: Embeddings adapter for the Ollama `/api/embed` wire shape.
---

# Class: OllamaEmbeddingsAdapter

Defined in: [src/batteries/embeddings/ollama/adapter.ts:50](https://github.com/NHTIO/ADK/blob/v1.20260718.0/src/src/batteries/embeddings/ollama/adapter.ts#L50)

Embeddings adapter for the Ollama `/api/embed` wire shape.

## Remarks

Reusable: construct once, call [OllamaEmbeddingsAdapter.embed](#embed) / [embedMany](#embedmany) as many
times as needed. `embedMany` issues one request per call (Ollama embeds a batch in a single
round-trip); `embed` is sugar over `embedMany([text])`.

## Constructors

### Constructor

```ts
new OllamaEmbeddingsAdapter(options: unknown): OllamaEmbeddingsAdapter;
```

Defined in: [src/batteries/embeddings/ollama/adapter.ts:67](https://github.com/NHTIO/ADK/blob/v1.20260718.0/src/src/batteries/embeddings/ollama/adapter.ts#L67)

#### Parameters

| Parameter | Type      | Description                             |
| --------- | --------- | --------------------------------------- |
| `options` | `unknown` | Constructor options. Validated eagerly. |

#### Returns

`OllamaEmbeddingsAdapter`

#### Throws

[@nhtio/adk/batteries/embeddings/ollama/exceptions!E\_INVALID\_OLLAMA\_EMBEDDINGS\_OPTIONS](../../exceptions/variables/E_INVALID_OLLAMA_EMBEDDINGS_OPTIONS.md) when `options` does not satisfy
[@nhtio/adk/batteries/embeddings/ollama/validation!ollamaEmbeddingsOptionsSchema](../../validation/variables/ollamaEmbeddingsOptionsSchema.md) (e.g. missing `model`).

## Accessors

### dimensions

#### Get Signature

```ts
get dimensions(): number | undefined;
```

Defined in: [src/batteries/embeddings/ollama/adapter.ts:72](https://github.com/NHTIO/ADK/blob/v1.20260718.0/src/src/batteries/embeddings/ollama/adapter.ts#L72)

Declared output dimensionality (from options), or `undefined` if not configured.

##### Returns

`number` | `undefined`

## Methods

### embed()

```ts
embed(text: string, opts?: EmbedOptions): Promise<number[]>;
```

Defined in: [src/batteries/embeddings/ollama/adapter.ts:103](https://github.com/NHTIO/ADK/blob/v1.20260718.0/src/src/batteries/embeddings/ollama/adapter.ts#L103)

Embeds a single string.

#### Parameters

| Parameter | Type                                                               | Description                |
| --------- | ------------------------------------------------------------------ | -------------------------- |
| `text`    | `string`                                                           | The input text.            |
| `opts?`   | [`EmbedOptions`](../../../openai/types/interfaces/EmbedOptions.md) | Per-call options (`kind`). |

#### Returns

`Promise`<`number`\[]>

The embedding vector as a plain `number[]`.

***

### embedMany()

```ts
embedMany(texts: string[], opts?: EmbedOptions): Promise<number[][]>;
```

Defined in: [src/batteries/embeddings/ollama/adapter.ts:118](https://github.com/NHTIO/ADK/blob/v1.20260718.0/src/src/batteries/embeddings/ollama/adapter.ts#L118)

Embeds a batch of strings in a single request.

#### Parameters

| Parameter | Type                                                               | Description                                                |
| --------- | ------------------------------------------------------------------ | ---------------------------------------------------------- |
| `texts`   | `string`\[]                                                         | The input texts.                                           |
| `opts?`   | [`EmbedOptions`](../../../openai/types/interfaces/EmbedOptions.md) | Per-call options (`kind`). Defaults to `kind: 'document'`. |

#### Returns

`Promise`<`number`\[]\[]>

One embedding vector per input, in input order, each a plain `number[]`.

#### Throws

[@nhtio/adk/batteries/embeddings/ollama/exceptions!E\_OLLAMA\_EMBEDDINGS\_HTTP\_ERROR](../../exceptions/variables/E_OLLAMA_EMBEDDINGS_HTTP_ERROR.md) on a non-2xx response or transport failure.

#### Throws

[@nhtio/adk/batteries/embeddings/ollama/exceptions!E\_OLLAMA\_EMBEDDINGS\_REQUEST\_TIMEOUT](../../exceptions/variables/E_OLLAMA_EMBEDDINGS_REQUEST_TIMEOUT.md) when the handshake exceeds `requestTimeoutMs`.

#### Throws

[@nhtio/adk/batteries/embeddings/ollama/exceptions!E\_OLLAMA\_EMBEDDINGS\_MALFORMED\_RESPONSE](../../exceptions/variables/E_OLLAMA_EMBEDDINGS_MALFORMED_RESPONSE.md) when the 2xx body is not the expected shape.

***

### isAvailable()

```ts
isAvailable(): boolean;
```

Defined in: [src/batteries/embeddings/ollama/adapter.ts:77](https://github.com/NHTIO/ADK/blob/v1.20260718.0/src/src/batteries/embeddings/ollama/adapter.ts#L77)

See [OllamaEmbeddingsAdapter.isAvailable](#isavailable-1). Instance alias for surface-parity.

#### Returns

`boolean`

***

### preload()

```ts
preload(): Promise<void>;
```

Defined in: [src/batteries/embeddings/ollama/adapter.ts:85](https://github.com/NHTIO/ADK/blob/v1.20260718.0/src/src/batteries/embeddings/ollama/adapter.ts#L85)

No-op warm-up. The Ollama battery has no engine to preload; present for surface-parity with
the WebLLM battery so callers can treat the two interchangeably.

#### Returns

`Promise`<`void`>

***

### reset()

```ts
reset(): void;
```

Defined in: [src/batteries/embeddings/ollama/adapter.ts:92](https://github.com/NHTIO/ADK/blob/v1.20260718.0/src/src/batteries/embeddings/ollama/adapter.ts#L92)

No-op state reset. Present for surface-parity with the WebLLM battery.

#### Returns

`void`

***

### isAvailable()

```ts
static isAvailable(): boolean;
```

Defined in: [src/batteries/embeddings/ollama/adapter.ts:58](https://github.com/NHTIO/ADK/blob/v1.20260718.0/src/src/batteries/embeddings/ollama/adapter.ts#L58)

Whether this battery can run in the current environment. For the HTTP-backed Ollama battery
this is always `true` (a `fetch` is always resolvable); present for surface-parity with the
WebLLM battery's WebGPU gate.

#### Returns

`boolean`