loco-admin-web/specs/designs/11-models/form.md

Model Form Page

Overview

Shared <ModelForm> handles both create and edit. The mode toggle (External vs Managed) is chosen at the top in create mode and is locked in edit mode.

Follows the form layout in specs/designs/10-layout/form.md, only the details are documented in this spec.

Form Layout

Basic Information (shared)

Beyond the standard Icon + Name + Mode fields described in the layout spec:

• Icon: default language
• Name: placeholder e.g. Qwen3-4B
• Model Category: Language | Embedding | Reranker; default Language

Description and tags are supported in Basic Information.

Two optional sub-sections:

Provider (nested, collapsible)

• Base Model ID
• Family
• Release Date
• Parameter Count

Capabilities (nested, collapsible)

• Inputs: Text | Image | Video | Audio; default [text]
• Outputs: Text | Image | Video | Audio; default [text]
• Language models: context window, max output tokens, inputs, outputs
• Embedding models: embedding dimensions, max input tokens
• Languages: list input (e.g. English, Chinese, Spanish)
• Tags: list input (e.g. Reasoning, Tool Use, Code Generation)

Deployment (managed only)

• Hugging Face Endpoint
• Hugging Face Repository (required)
• Revision
• File
• Runtime Settings

Endpoint (external mode)

• Provider
• Model ID (providerModel)
• API Base
• API Version
• Auth fields

Inference Settings

• External language models: optional default sampling (temperature, maxTokens, topP)
• Managed models: context window and optional runtime sampling (temperature, topK, topP) for language category

Validation

• Name is required

Breadcrumb

• Create: Models / [New Model]
• Edit: Models / Edit [{model.name}]