Files
odysseus/specs/model-providers/local-compatible-engines.md
T

38 lines
1.5 KiB
Markdown

# Other Local And Proxy Compatible Engines
Last updated: dev@28d27ee | 2026-07-17
## Scope
Canonical explicit identities `mlx_lm`, `text_generation_inference`,
`lmdeploy`, and `litellm`, plus unknown OpenAI-compatible deployments not
covered by the native Ollama, LM Studio, llama.cpp, vLLM, or SGLang specs.
## Shape
Use explicit endpoint kind when known; otherwise use only the general model
list envelopes for inventory identity. Capability-looking structural fields
remain raw. Local host and port do not distinguish these engines.
MLX/Cookbook launch recipes, TGI task configuration, LMDeploy
adapters, and LiteLLM upstream routing can all change capability independently
of the model ID.
Proxy model aliases are endpoint scoped. A proxy may return richer fields, but
unknown keys remain raw until a versioned shape is added. Provider-specific
headers/extensions must not be applied based on a port or upstream model name.
## Fallback And Safety
Discovery can probe cheap native identity endpoints when available, but
capability probes execute only explicit bounded test contracts. Never read
broad server/environment dumps as ordinary model metadata. Unknown compatible
servers should still list identities and make conservative text calls where
explicitly configured, without appearing on capability-gated surfaces.
## Current Gaps
- These engines need individual safe metadata fixtures before they can graduate
from general fallback.
- Gateway upstream identity and effective downstream model capability are not
yet represented as a chain.