[GH-ISSUE #14480] [Docs] Web UI silently hides BERT-only models while docs recommend them for embeddings #9391

Closed
opened 2026-04-12 22:18:28 -05:00 by GiteaMirror · 1 comment
Owner

Originally created by @oqoqo-bot on GitHub (Feb 26, 2026).
Original GitHub issue: https://github.com/ollama/ollama/issues/14480

Documentation Gap

The embeddings documentation recommends BERT-family models like all-minilm and embeddinggemma for generating embeddings. However, the web UI's getModels function filters out any model whose only family is "bert" — these models are installed and functional via CLI/API but invisible in the UI model selector.

Severity: medium

Description

The embeddings documentation recommends BERT-family models like all-minilm and embeddinggemma for generating embeddings. However, the web UI's getModels function filters out any model whose only family is "bert" — these models are installed and functional via CLI/API but invisible in the UI model selector. No documentation mentions this filtering.

  • The embeddings docs recommend models including all-minilm and embeddinggemma without mentioning UI limitations (embeddings.mdx:10-12)
  • getModels filters the model list by checking m.details?.families — if every family includes "bert", the model is excluded (api.ts:122-132)
  • The underlying ollama.list() API returns all models including BERT ones — the filtering happens only at the UI layer (api.ts:117)
  • No documentation, tooltip, or UI message explains why these models don't appear
  • Users who pull a recommended embedding model and open the web UI will not find it, with no indication of why

How to Validate

Affected Files

  • docs/capabilities/embeddings.mdx
  • app/ui/app/src/api.ts

Created by Oqoqo

Originally created by @oqoqo-bot on GitHub (Feb 26, 2026). Original GitHub issue: https://github.com/ollama/ollama/issues/14480 ## Documentation Gap The embeddings documentation recommends BERT-family models like `all-minilm` and `embeddinggemma` for generating embeddings. However, the web UI's `getModels` function filters out any model whose only family is `"bert"` — these models are installed and functional via CLI/API but invisible in the UI model selector. **Severity:** medium ## Description The embeddings documentation recommends BERT-family models like `all-minilm` and `embeddinggemma` for generating embeddings. However, the web UI's `getModels` function filters out any model whose only family is `"bert"` — these models are installed and functional via CLI/API but invisible in the UI model selector. No documentation mentions this filtering. - The embeddings docs recommend models including `all-minilm` and `embeddinggemma` without mentioning UI limitations ([embeddings.mdx:10-12](https://github.com/ollama/ollama/blob/main/docs/capabilities/embeddings.mdx#L10-L12)) - `getModels` filters the model list by checking `m.details?.families` — if every family includes `"bert"`, the model is excluded ([api.ts:122-132](https://github.com/ollama/ollama/blob/main/app/ui/app/src/api.ts#L122-L132)) - The underlying `ollama.list()` API returns all models including BERT ones — the filtering happens only at the UI layer ([api.ts:117](https://github.com/ollama/ollama/blob/main/app/ui/app/src/api.ts#L117)) - No documentation, tooltip, or UI message explains why these models don't appear - Users who pull a recommended embedding model and open the web UI will not find it, with no indication of why ## How to Validate - [Confirm embeddings docs recommend BERT-family models.](https://github.com/ollama/ollama/blob/main/docs/capabilities/embeddings.mdx#L10-L12) - [Confirm getModels filters out BERT-only models.](https://github.com/ollama/ollama/blob/main/app/ui/app/src/api.ts#L122-L132) - [Confirm no docs mention UI model filtering behavior. Search docs/ for "filter", "hidden", "BERT", "not appear"](https://docs.ollama.com/) ## Affected Files - `docs/capabilities/embeddings.mdx` - `app/ui/app/src/api.ts` --- *Created by [Oqoqo](https://oqoqo.ai)*
Author
Owner

@rick-github commented on GitHub (Feb 27, 2026):

There's no point in having embedding models in the chat interface. Please don't post any more AI rubbish.

<!-- gh-comment-id:3970080295 --> @rick-github commented on GitHub (Feb 27, 2026): There's no point in having embedding models in the chat interface. Please don't post any more AI rubbish.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/ollama#9391