[PR #22436] [CLOSED] feat: support upstream model metadata from /v1/models response #65549

Closed
opened 2026-05-06 11:24:31 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/open-webui/pull/22436
Author: @mpcusack-altos
Created: 3/8/2026
Status: Closed

Base: devHead: feat/upstream-model-metadata


📝 Commits (10+)

📊 Changes

1 file changed (+26 additions, -0 deletions)

View changed files

📝 backend/open_webui/utils/models.py (+26 -0)

📄 Description

Pull Request Checklist\n\n- [x] Target branch: dev\n- [x] Description: See below\n- [x] Changelog: See below\n- [x] Testing: Manual testing with a custom OpenAI-compatible backend returning meta in /v1/models. Verified: upstream meta appears in UI, DB overrides take precedence, DEFAULT_MODEL_METADATA still applies as base.\n- [x] Code review: Self-reviewed\n- [x] Title Prefix: feat\n\n# Changelog Entry\n\n### Description\n\nAllow OpenAI-compatible backends to include an optional meta object in their /v1/models response entries. OpenWebUI reads profile_image_url, description, and capabilities from it — applying them as defaults that DB overrides and DEFAULT_MODEL_METADATA can still override.\n\nThis enables managing model presentation (icons, descriptions, capability flags) as infrastructure-as-code on the backend side, without requiring manual configuration in the OpenWebUI admin UI for each model.\n\nPrecedence (lowest to highest):\n1. DEFAULT_MODEL_METADATA config (global blanket defaults for all models)\n2. Upstream meta from /v1/models response (model-specific from the provider)\n3. DB model override (admin UI / API)\n\n### Example upstream /v1/models response entry\n\njson\n{\n \"id\": \"claude-sonnet-4-20250514\",\n \"object\": \"model\",\n \"owned_by\": \"anthropic\",\n \"meta\": {\n \"profile_image_url\": \"https://example.com/anthropic-icon.png\",\n \"description\": \"Anthropic's Claude Sonnet 4\",\n \"capabilities\": { \"vision\": true }\n }\n}\n\n\n### Added\n\n- Upstream model metadata support: OpenWebUI now reads meta.profile_image_url, meta.description, and meta.capabilities from /v1/models response entries served by OpenAI-compatible backends (including Ollama)\n\n### Changed\n\n- get_all_models() in backend/open_webui/utils/models.py — added a new loop after the DEFAULT_MODEL_METADATA block that applies upstream meta fields, skipping models with DB overrides\n\n### Why no other files need changes\n\n- openai.py: Already preserves all upstream fields via **model spread and stores the original in model[\"openai\"]\n- Frontend (Svelte): Already reads info.meta for display (profile_image_url, description, capabilities)\n\n---\n\n### Additional Information\n\n- ~26 lines of new code in a single file\n- No new dependencies\n- No frontend changes required\n- No breaking changes — purely additive; backends that don't include meta are unaffected\n\n### Contributor License Agreement\n\n- [x] By submitting this pull request, I confirm that I have read and fully agree to the Contributor License Agreement (CLA), and I am providing my contributions under its terms.


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/open-webui/pull/22436 **Author:** [@mpcusack-altos](https://github.com/mpcusack-altos) **Created:** 3/8/2026 **Status:** ❌ Closed **Base:** `dev` ← **Head:** `feat/upstream-model-metadata` --- ### 📝 Commits (10+) - [`fe6783c`](https://github.com/open-webui/open-webui/commit/fe6783c16699911c7be17392596d579333fb110c) Merge pull request #19030 from open-webui/dev - [`fc05e0a`](https://github.com/open-webui/open-webui/commit/fc05e0a6c5d39da60b603b4d520f800d6e36f748) Merge pull request #19405 from open-webui/dev - [`e3faec6`](https://github.com/open-webui/open-webui/commit/e3faec62c58e3a83d89aa3df539feacefa125e0c) Merge pull request #19416 from open-webui/dev - [`9899293`](https://github.com/open-webui/open-webui/commit/9899293f050ad50ae12024cbebee7e018acd851e) Merge pull request #19448 from open-webui/dev - [`140605e`](https://github.com/open-webui/open-webui/commit/140605e660b8186a7d5c79fb3be6ffb147a2f498) Merge pull request #19462 from open-webui/dev - [`6f1486f`](https://github.com/open-webui/open-webui/commit/6f1486ffd0cb288d0e21f41845361924e0d742b3) Merge pull request #19466 from open-webui/dev - [`d95f533`](https://github.com/open-webui/open-webui/commit/d95f533214e3fe5beb5e41ec1f349940bc4c7043) Merge pull request #19729 from open-webui/dev - [`a727153`](https://github.com/open-webui/open-webui/commit/a7271532f8a38da46785afcaa7e65f9a45e7d753) 0.6.43 (#20093) - [`6adde20`](https://github.com/open-webui/open-webui/commit/6adde203cd292a9e3af9c64a2ae36b603fed096a) Merge pull request #20394 from open-webui/dev - [`f9b0534`](https://github.com/open-webui/open-webui/commit/f9b0534e0c442631d1cb7205169588b9b6204179) Merge pull request #20522 from open-webui/dev ### 📊 Changes **1 file changed** (+26 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `backend/open_webui/utils/models.py` (+26 -0) </details> ### 📄 Description # Pull Request Checklist\n\n- [x] **Target branch:** `dev`\n- [x] **Description:** See below\n- [x] **Changelog:** See below\n- [x] **Testing:** Manual testing with a custom OpenAI-compatible backend returning `meta` in `/v1/models`. Verified: upstream meta appears in UI, DB overrides take precedence, DEFAULT_MODEL_METADATA still applies as base.\n- [x] **Code review:** Self-reviewed\n- [x] **Title Prefix:** `feat`\n\n# Changelog Entry\n\n### Description\n\nAllow OpenAI-compatible backends to include an optional `meta` object in their `/v1/models` response entries. OpenWebUI reads `profile_image_url`, `description`, and `capabilities` from it — applying them as defaults that DB overrides and `DEFAULT_MODEL_METADATA` can still override.\n\nThis enables managing model presentation (icons, descriptions, capability flags) as infrastructure-as-code on the backend side, without requiring manual configuration in the OpenWebUI admin UI for each model.\n\n**Precedence (lowest to highest):**\n1. `DEFAULT_MODEL_METADATA` config (global blanket defaults for all models)\n2. Upstream `meta` from `/v1/models` response (model-specific from the provider)\n3. DB model override (admin UI / API)\n\n### Example upstream `/v1/models` response entry\n\n```json\n{\n \"id\": \"claude-sonnet-4-20250514\",\n \"object\": \"model\",\n \"owned_by\": \"anthropic\",\n \"meta\": {\n \"profile_image_url\": \"https://example.com/anthropic-icon.png\",\n \"description\": \"Anthropic's Claude Sonnet 4\",\n \"capabilities\": { \"vision\": true }\n }\n}\n```\n\n### Added\n\n- Upstream model metadata support: OpenWebUI now reads `meta.profile_image_url`, `meta.description`, and `meta.capabilities` from `/v1/models` response entries served by OpenAI-compatible backends (including Ollama)\n\n### Changed\n\n- `get_all_models()` in `backend/open_webui/utils/models.py` — added a new loop after the `DEFAULT_MODEL_METADATA` block that applies upstream `meta` fields, skipping models with DB overrides\n\n### Why no other files need changes\n\n- **openai.py**: Already preserves all upstream fields via `**model` spread and stores the original in `model[\"openai\"]`\n- **Frontend (Svelte)**: Already reads `info.meta` for display (`profile_image_url`, `description`, `capabilities`)\n\n---\n\n### Additional Information\n\n- ~26 lines of new code in a single file\n- No new dependencies\n- No frontend changes required\n- No breaking changes — purely additive; backends that don't include `meta` are unaffected\n\n### Contributor License Agreement\n\n- [x] By submitting this pull request, I confirm that I have read and fully agree to the [Contributor License Agreement (CLA)](https://github.com/open-webui/open-webui/blob/main/CONTRIBUTOR_LICENSE_AGREEMENT), and I am providing my contributions under its terms. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-05-06 11:24:31 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/open-webui#65549