zeno-provider-openai

OpenAI-compatible Chat Completions provider for Zeno. One adapter covers every vendor that speaks the OpenAI REST shape: OpenAI, OpenRouter, LiteLLM, Azure v1, Ollama, vLLM, and anything that clones the wire protocol.

Install

uv add 'zeno-framework[openai]'

Usage

from zeno.agent import Agent
from zeno.app import ZenoApp
from zeno.channels.cli.channel import CliChannel
from zeno.providers.openai import OpenAIProvider

app = ZenoApp(
    agent=Agent(name="root", instructions="..."),
    channels=[CliChannel()],
    provider=OpenAIProvider(
        api_key="sk-...",
        base_url="https://api.openai.com/v1",
        model="gpt-5.1",
    ),
)

Swap providers without changing your Agent:

# OpenRouter
OpenAIProvider(
    api_key="...",
    base_url="https://openrouter.ai/api/v1",
    model="anthropic/claude-sonnet-4.6",
    extra_headers={"HTTP-Referer": "https://yourapp", "X-Title": "yourapp"},
)

# LiteLLM
OpenAIProvider(api_key="...", base_url="http://litellm:4000/v1", model="anthropic/claude-sonnet-4.6")

# Azure v1 (/openai/v1/ surface)
OpenAIProvider(api_key="...", base_url="https://YOUR.openai.azure.com/openai/v1", model="gpt-5.1")

# Ollama — non-streaming when tools are present (known upstream bug)
OpenAIProvider(api_key="ollama", base_url="http://localhost:11434/v1", model="llama4",
               disable_stream_with_tools=True)

Compatibility matrix

What this provider does not support

• built_in_tools (Claude Agent SDK native tools — no OpenAI equivalent)
• sub_agents (Claude Agent SDK dispatch contract)
• permission_mode (Claude-specific)

Configure those on ClaudeSDKProvider. Zeno's ZenoApp.start() catches mismatches.

See also

• zeno-provider-claude — Claude Agent SDK provider with sub-agents and built-in tools.
• docs/adapters.md — writing your own Provider.

Part of the Zeno framework.