Providers

Connect to any LLM provider with a single line.

chainforge’s core.Provider interface decouples your agent logic from any specific SDK. Swapping providers requires changing exactly one line.

Available providers

Provider	Package	Shorthand
Anthropic (Claude)	pkg/providers/anthropic	WithAnthropic(key, model)
OpenAI	pkg/providers/openai	WithOpenAI(key, model)
Google Gemini	pkg/providers/gemini	WithGemini(key, model)
Ollama	pkg/providers/ollama	WithOllama(url, model)
Any OpenAI-compatible API	pkg/providers/openai	WithOpenAICompatible(key, url, name, model)

Usage

Anthropic

chainforge.WithAnthropic(os.Getenv("ANTHROPIC_API_KEY"), "claude-sonnet-4-6")

Gemini convenience constructors

The pkg/providers/gemini package includes named constructors for common models:

import "github.com/lioarce01/chainforge/pkg/providers/gemini"

p, err := gemini.NewFlash(apiKey)  // gemini-2.0-flash — fast, cost-effective
p, err := gemini.NewPro(apiKey)    // gemini-2.0-pro

Custom provider

Implement core.Provider to add any backend:

type Provider interface {
    Name() string
    Chat(ctx context.Context, req ChatRequest) (ChatResponse, error)
    ChatStream(ctx context.Context, req ChatRequest) (<-chan StreamEvent, error)
}

pkg/core has zero external dependencies — a custom provider never pulls any SDK into your binary unless you need it.