config.example.yml

# Example conclave config. Copy to ~/.conclave/config.yml and edit.
# This file references providers by NAME only and contains NO API keys.
# Keys always come from environment variables (see README).

# Friendly name -> provider-prefixed model id. Overrides/extends the built-in defaults.
models:
  grok: xai/grok-4.3
  gemini: gemini/gemini-2.5-pro
  claude: anthropic/claude-sonnet-4-6
  perplexity: perplexity/sonar-pro
  openai: openai/gpt-4.1

# Named councils you can pass to `--council <name>`.
councils:
  default: [grok, gemini, claude, perplexity]
  fast: [grok, perplexity]
  frontier: [claude, gemini, openai]

# Default synthesizer (friendly name). Overridable with `--synthesizer`.
# The synthesizer also runs the default-on verdict extraction (one extra call per
# run): on a decision/review prompt with >=2 responding members, conclave adjudicates
# the answers into a scored, auditable verdict on `result.verdict`/`result.manifest`.
# There is no config switch for it -- opt out in code via Council(extract_verdict=False).
synthesizer: claude

# Optional result cache (OFF by default). When true, an identical repeat run is
# served from an on-disk cache instead of re-calling the providers -- handy for
# repeated/eval runs. Override per invocation with `--cache` / `--no-cache`.
# The cache is keyed on (prompt, council, mode, model ids) and NEVER stores keys.
# Stored under $XDG_CACHE_HOME/conclave (else ~/.cache/conclave).
cache: false

# Optional debate early-stop on convergence (OFF by default, unset). When set to
# a value in [0.0, 1.0], a `--mode debate` run stops before `--rounds` is
# exhausted once answers stabilize round-over-round (a difflib similarity ratio
# averaged across members reaches this threshold). Leave unset for the historic
# fixed-rounds behavior. Override per invocation with `--converge-threshold` or
# `--converge` / `--no-converge`. A high value (e.g. 0.95) only stops on
# near-identical successive answers.
# converge_threshold: 0.95