Providers

SwarmVault uses a capability-driven provider abstraction that supports multiple LLM backends through a unified interface.

Supported Providers

TypeDescriptionRequires API Key
heuristicLocal fallback using term frequency and regexNo
openaiOpenAI API (GPT-4o, etc.)Yes
anthropicAnthropic API (Claude)Yes
geminiGoogle Gemini APIYes
ollamaLocal Ollama instanceNo
openai-compatibleAny OpenAI-compatible APIVaries
customLoad from a custom moduleVaries

Provider Capabilities

Each provider declares its capabilities:

  • responses — OpenAI Responses API format
  • chat — Chat completions format
  • structured — Structured/JSON output
  • tools — Tool/function calling
  • vision — Image understanding
  • embeddings — Text embeddings
  • streaming — Streaming responses
  • local — Runs locally without network

Provider Interface

All providers implement:

  • generateText(request) — Generate plain text
  • generateStructured(request, schema) — Generate validated structured output

See individual provider pages for configuration details.