OSS-first docs
These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.
Mistral
Integrate Mistral models for chat, reasoning, embeddings, speech-to-text, and conversational voice workflows. ContractSpec ships first-class Mistral support across contracts, provider runtime wiring, and CLI provider selection.
Setup
# .env MISTRAL_API_KEY=...
Chat and reasoning
capabilityId: mistral-chat
provider:
type: mistral
operation: chatCompletion
inputs:
messages:
type: array
model:
type: string
default: "mistral-large-latest"
temperature:
type: number
optional: true
outputs:
content:
type: string
usage:
type: objectEmbeddings
capabilityId: mistral-embeddings
provider:
type: mistral
operation: createEmbedding
inputs:
text:
type: string
model:
type: string
default: "mistral-embed"
outputs:
embedding:
type: array
items:
type: numberSpeech-to-Text (Voxtral)
capabilityId: mistral-stt
provider:
type: mistral
operation: transcribe
inputs:
audio:
type: bytes
format:
type: string
language:
type: string
optional: true
outputs:
text:
type: string
segments:
type: array
language:
type: stringConversational voice sessions
Use the conversational provider for session-based realtime voice flows (turn handling, events, and interruption-safe streaming).
Best practices
- Choose model families by workload: coding, reasoning, or speech
- Persist session IDs for conversational continuity across turns
- Capture token and latency telemetry for provider-level tuning
- Set explicit fallbacks for network and rate-limit failures
OpenAI integration
Connect OpenAI through typed capabilities, explicit provider config, and governed runtime usage.
Qdrant integration
Store and retrieve knowledge embeddings with explicit provider configuration and ownership.
Why ContractSpec
Keep educational and comparison content reachable without letting it define the primary OSS learning path.