Image Studio docs: require setting a separate Task Model after install

tool_choice: required (the thing that makes Image Studio reliably fire
its tools) also blocks Open WebUI's background text-only calls — title
generation, tag suggestions, autocomplete — because the model is
forced to produce a tool call instead of text. Result: chats stay
named 'New Chat' and tag suggestions go silent.

Documented the fix in two places:
  - image_studio.md: dedicated 'Set a separate Task Model (required
    after install)' section explaining the cause and the fix path.
  - deployment README §9: short follow-up note pointing at it so
    operators don't miss it during initial setup.

The fix is purely Open WebUI configuration — no code change. Pick any
non-Image-Studio model already pulled (mistral-nemo:12b is the
obvious default) for the Task Model slot.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-19 15:37:21 -05:00
co-authored by Claude Opus 4.7
parent 6700f6ce33
commit e77666ea0f
2 changed files with 30 additions and 0 deletions
+9
View File
@@ -218,6 +218,15 @@ Setup — two paths:
Users then pick **Image Studio** from the chat-model dropdown when
they want to generate or edit images.
**One required follow-up** after either install path: set a separate
**Task Model** in Admin Settings → Interface → Task Model. Image
Studio uses `tool_choice: required` to force tool calls, which means
the same model can't produce the text responses Open WebUI needs for
chat-title generation, tag suggestions, and autocomplete. Pick any
non-Image-Studio model you have pulled (`mistral-nemo:12b`,
`llama3.1:8b`, etc.) — see the
[**Set a separate Task Model** section in image_studio.md](openwebui-models/image_studio.md#set-a-separate-task-model-required-after-install).
The preset ships with `vision: true` so users can attach images for
editing even though `mistral-nemo:12b` isn't a vision model — see the
[**Vision capability** section in image_studio.md](openwebui-models/image_studio.md#vision-capability)
@@ -139,6 +139,27 @@ The first line `/no_think` disables Qwen 3.x's reasoning phase. If
your base model isn't Qwen 3, leaving it in is a no-op (other models
ignore it). Drop it only if it actually causes problems.
## Set a separate Task Model (required after install)
`tool_choice: required` is what makes Image Studio reliably fire the
tool, but it has a side effect: Open WebUI uses the same model with
the same params for **title generation**, **tag generation**, and
**autocomplete**. With every response forced to be a tool call, those
text-only background tasks can't produce text, so chats stay named
"New Chat" forever and tag suggestions go silent.
Fix: point Open WebUI at a different model for those tasks.
**Admin Settings → Interface → Task Model** → pick any of the
non-Image-Studio models you have pulled. `mistral-nemo:12b`,
`llama3.1:8b`, `qwen3.6:latest`, or `dolphin3:8b` all work. The Task
Model only handles short background calls (titles, tags, autocomplete,
search-query rewriting) — it doesn't need to be vision-capable or
particularly large. Smaller is faster and cheaper.
Save. New Image Studio chats now get descriptive titles, tag
suggestions return, and autocomplete lights up.
## Vision capability
The shipped preset sets `meta.capabilities.vision: true` so Open WebUI