Choose a Backend

yggdrasil separates orchestration from model providers.

Fast Rule Of Thumb

• Use provider="anthropic" if you want the default hosted path
• Use provider="compatible" for OpenAI-compatible APIs, including OpenAI itself
• Pass backend=... directly when you need full control

Builder API

Anthropic:

from yggdrasil import GraphApp

app = GraphApp(provider="anthropic", api_key="sk-ant-...")

Compatible hosted API:

from yggdrasil import GraphApp

app = GraphApp(
    provider="compatible",
    api_key="sk-...",
)

Local compatible server:

from yggdrasil import GraphApp

app = GraphApp(
    provider="compatible",
    # `provider="openai"` still works as a compatibility alias.
    base_url="http://localhost:11434/v1",
    api_key="ollama",
)

Low-Level API

from yggdrasil import GraphExecutor, OpenAIBackend

executor = GraphExecutor(
    store,
    backend=OpenAIBackend(base_url="http://localhost:11434/v1", api_key="ollama"),
)

Why This Split Exists

The runtime should not force a single model provider. The builder API is there to make setup discoverable, while the low-level backend classes still expose full control.