Self-hosting

AI providers

AI review is optional. The deterministic gate still runs when no provider is configured.

Provider options

anthropic: Native Anthropic Messages API. Requires ANTHROPIC_API_KEY.
openai or openai-compatible: OpenAI chat completions shape. Works with OpenAI, gateway providers, vLLM, Ollama, and compatible endpoints.
ollama: Local model endpoint. Good for private experiments; quality depends on the pulled model.
claude-code: Subscription CLI path. Requires CLI availability and CLAUDE_CODE_OAUTH_TOKEN from an interactive setup.
codex: Subscription CLI path. Treat credentials carefully; do not mount prompt-readable auth into untrusted review sandboxes.

Single provider

.env

AI_PROVIDER=anthropic
ANTHROPIC_API_KEY=<provider-key>
ANTHROPIC_AI_MODEL=claude-sonnet-4-6

ANTHROPIC_AI_BASE_URL defaults to https://api.anthropic.com — set it only to route through a gateway or proxy in front of the real Anthropic API.

OpenAI API

Distinct from OpenAI-compatible below: this is the native OpenAI API path (AI_PROVIDER=openai), for when you have an OpenAI account key rather than a gateway or local endpoint.

.env

AI_PROVIDER=openai
OPENAI_API_KEY=<provider-key>
OPENAI_AI_BASE_URL=https://api.openai.com/v1
OPENAI_AI_MODEL=gpt-5.5

OPENAI_AI_BASE_URL and OPENAI_AI_MODEL already default to the values shown — set them only to override the endpoint or model.

OpenAI-compatible endpoint

.env

AI_PROVIDER=openai-compatible
OPENAI_COMPATIBLE_AI_BASE_URL=http://ollama:11434/v1
OPENAI_COMPATIBLE_AI_API_KEY=
OPENAI_COMPATIBLE_AI_MODEL=llama3.1

Ollama (dedicated provider)

AI_PROVIDER=ollama is a separate provider id from routing Ollama through openai-compatible above — use whichever matches how you want fallback/dual-review chains to identify it. Defaults to a local Ollama at http://localhost:11434/v1 with no API key.

.env

AI_PROVIDER=ollama
OLLAMA_AI_BASE_URL=http://ollama:11434/v1
OLLAMA_AI_API_KEY=
OLLAMA_AI_MODEL=llama3.1

Set OLLAMA_AI_BASE_URL to http://ollama:11434/v1 when using the compose ollama profile; OLLAMA_AI_API_KEY is normally left blank for a local, unauthenticated Ollama instance.

Fallback and dual review

A comma-list is a fallback chain by default. Use this for subscription CLIs when you want Codex first and Claude Code only when Codex is unavailable or out of tokens.

.env — fallback chain

AI_PROVIDER=codex,claude-code
CODEX_AI_EFFORT=medium
CLAUDE_AI_EFFORT=medium
CLAUDE_CODE_OAUTH_TOKEN=
GITTENSORY_ENABLE_UNSAFE_CODEX_REVIEWER=1

Set AI_DUAL_REVIEW=1 only when you want the first two providers to run as independent reviewers on every PR. In dual-review mode, AI_COMBINE controls how decisions are combined.

.env — dual review

AI_PROVIDER=anthropic,ollama
AI_DUAL_REVIEW=1
AI_COMBINE=synthesis
AI_ON_MERGE=either

single: One reviewer verdict. This is the automatic mode for one provider or a fallback chain.
consensus: Block only when both reviewers flag a critical defect. A lone defect holds for human review.
synthesis: Both reviewers run, then one merged decision is produced. AI_ON_MERGE controls either or both.

Subscription CLI safety

Credential isolation matters

Subscription CLIs store credentials on disk. Do not mount a writable or prompt-readable CLI home into review execution unless you have isolated it from PR-controlled content. Use an API provider or local OpenAI-compatible endpoint when isolation is not clear.

Related context

AI providers produce the review. REES and RAG add context that the reviewer can use.

← PreviousGitHub App & Orb Next →REES enrichment