Skip to main content

OpenPrism

Many diverse model voices, split and recombined into one judged answer.

CI License: MIT Python 3.10+

OpenPrism sends your prompt to a panel of different models in parallel, then a judge model reconciles their answers. The judge runs an explicit pass over them (consensus, contradictions, gaps, blind spots) and writes one response that beats any single model's. It's the OpenRouter "Fusion" pattern as a small, self-hostable tool.

Works with Claude Code, opencode, Cursor, Windsurf, Gemini CLI, and Codex, or anything that speaks MCP. It runs on models you already have: any model configured in opencode (75+ providers, recommended, no extra keys), or your own OpenAI-compatible provider keys.


Why it works

  • Diversity beats raw strength. Independent models from different houses catch different things, and a judge that reconciles them does better than any single model on open-ended problems.
  • Parallel panel. Wall-clock is about the slowest panelist, not the sum, so a fourth model adds almost no latency.
  • Use it deliberately. A call costs roughly the slowest model plus the judge. Point it at hard questions (research, architecture, ambiguous trade-offs), not routine work.
  • Diversity is counted by model family, not by raw count. OpenPrism picks default panels by family (Anthropic, OpenAI, Google, Qwen, GLM, Kimi, MiniMax, and so on), so two models from the same maker don't count as two voices. Every run is graded: full (all panelists answered, at least OPENPRISM_MIN_FAMILIES distinct families), degraded (a panelist failed but the family floor still holds), or stop (fewer than the floor answered, i.e. a single-family monoculture). The grade always prints, and OPENPRISM_STRICT=1 refuses a stop outright.

How it works

            ┌──────────── panel (parallel) ────────────┐
prompt ───▶ │  model A    model B    model C    model D │ ──▶  judge ──▶ answer
            └───────────────────────────────────────────┘   (reconcile +
                  (different providers / houses)               synthesize)

Two backends decide where panel calls go (set with OPENPRISM_BACKEND):

Backend Models from Use
opencode (default, recommended) every provider/model authed in opencode, discovered live, nothing hardcoded, no keys in OpenPrism easiest; just opencode auth login your providers
direct your own OpenAI-compatible provider keys (.env / providers.json) when you don't run opencode

Two modes:

  • research (default). Fusion-style synthesis. This is the mode with measured benchmark benefit.
  • code. Code is verifiable, so blending prose is wrong. Each model produces a candidate, then the judge picks the strongest one and repairs it (best-of-N) and adds a Verify by: line. v1 does not auto-run the tests yet.

Install

Pick whichever fits. All of them work on Linux, macOS, Windows, and WSL.

A. Claude Code marketplace (simplest):

/plugin marketplace add ba1lly/OpenPrism
/plugin install openprism@openprism

B. Any MCP host via uvx (needs uv; no clone, no venv). Generate the config for your host with the built-in wizard:

uvx openprism init --host opencode
#   ...or --host cursor | windsurf | gemini | codex | claude-code

It prints (or --writes) the MCP config block, launching the server via uvx --from openprism openprism-mcp (the published PyPI package). For the latest GitHub branch use --git; to pin a tag use --ref v0.1.0.

C. From source (for development):

git clone https://github.com/ba1lly/OpenPrism && cd OpenPrism
./install.sh          # Linux / macOS / WSL   (Windows: ./install.ps1)

The installer creates a venv, installs OpenPrism, seeds .env, and prints host config. To point a host at this checkout, run openprism init --host <h> --local.

Then add a provider key to .env (direct backend), or set OPENPRISM_BACKEND=opencode to use opencode's providers with no keys here.

Judge options

OPENPRISM_JUDGE_BACKEND OPENPRISM_JUDGE_MODEL Notes
claude-code (default) alias, e.g. opus claude -p headless via a Claude Max plan
anthropic-api opus or a model id metered Anthropic API key
opencode provider/model ref routes the judge through opencode too

Usage (CLI)

openprism "Best architecture for X, and the trade-offs?"          # research
openprism "Implement a token-bucket rate limiter" --mode code
openprism "..." --panel "google/gemini-2.5-flash,anthropic/claude-haiku-4-5"
openprism --bakeoff modelA modelB "a hard prompt"                 # which model wins?
openprism --list                                                  # presets + known models
openprism doctor                                                  # check your setup

With OPENPRISM_BACKEND=opencode, panels are provider/model refs. With no --panel, OpenPrism picks a diverse default across your connected providers.

Use as a plugin

OpenPrism is one MCP server with four tools (research, code, bakeoff, models), so every host calls the same core. openprism init --host <host> generates the right config for each:

Host Config file Tools surface as
Claude Code marketplace, or .mcp.json mcp__openprism__research etc.; commands /openprism*
opencode ~/.config/opencode/opencode.json openprism_research etc.; commands /openprism*
Cursor ~/.cursor/mcp.json openprism MCP tools
Windsurf ~/.codeium/windsurf/mcp_config.json openprism MCP tools
Gemini CLI ~/.gemini/settings.json openprism MCP tools
Codex ~/.codex/config.toml openprism MCP tools
openprism init --host cursor            # print the block
openprism init --host opencode --write  # merge it into the config file (makes a .bak)

For opencode, also copy the command files for slash commands:

cp integrations/opencode/commands/*.md ~/.config/opencode/commands/

Run /openprism-models (or the models tool) to see which provider/model refs are connected.

Panelist tools (opencode backend)

Like Fusion, panelists can use live web tools. On the opencode backend the panel runs according to OPENPRISM_PANEL_TOOLS:

Value Panelists get
research (default, research mode) webfetch + websearch + read-only; all mutation tools denied (write/edit/apply_patch/bash/task/todowrite)
none pure completions (model knowledge only); used for code/bakeoff
all every opencode tool including bash/edit/write. Opt-in, and it runs on your machine.

The direct backend is plain completions and ignores tools.

Adding models & providers

opencode backend (recommended): you don't add anything to OpenPrism. Add the provider in opencode and it shows up automatically:

opencode auth login          # pick a provider, paste its key / OAuth

Then run /openprism-models (or the models tool) in any host to see every provider/model ref now available, and use them:

openprism "..." --panel "anthropic/claude-opus-4-7,google/gemini-3-pro,openai/gpt-5.2"

With no --panel, OpenPrism picks a diverse default across your connected providers, or set OPENPRISM_PANEL to pin a fixed default panel.

direct backend: add providers to OpenPrism. The default provider comes from .env (ALIBABA_API_KEY + ALIBABA_BASE_URL). Add more OpenAI-compatible providers in providers.json (copy providers.json.example):

{ "openrouter": { "base_url": "https://openrouter.ai/api/v1",
                  "api_key": "env:OPENROUTER_API_KEY",
                  "models": ["anthropic/claude-opus-4", "google/gemini-2.5-pro"] } }

Reference them as provider/model in --panel.

The judge model is independent of the panel. Set OPENPRISM_JUDGE_BACKEND and OPENPRISM_JUDGE_MODEL (see the judge table).

Health check & uninstall

openprism doctor      # checks backend, opencode server, judge, keys; prints no secrets
./uninstall.sh        # or ./uninstall.ps1; removes venv/build, leaves your .env

Configuration

Everything is set through env vars (.env in the repo root; see .env.example): OPENPRISM_BACKEND, OPENPRISM_JUDGE_BACKEND, OPENPRISM_JUDGE_MODEL, ANTHROPIC_API_KEY (for the anthropic-api judge), OPENPRISM_DEFAULT_PROVIDER (which direct provider a bare model id uses), OPENPRISM_PANEL (pin the default panel: a preset name or comma-separated model refs; a per-call panel overrides it), OPENPRISM_PANEL_TOOLS (research/none/all), OPENPRISM_MIN_FAMILIES (diversity floor, default 2), OPENPRISM_STRICT (refuse below the floor), OPENPRISM_MAX_PANEL (size cap), OPENPRISM_PANEL_TIMEOUT, OPENPRISM_MAX_TOKENS, and the opencode-backend OPENPRISM_OPENCODE_* settings. Extra direct-backend providers go in providers.json (see providers.json.example).

Security notes

  • OpenPrism never logs provider keys. The opencode backend queries only the keyless /provider endpoint (never /config/providers, which would return keys), and the judge always runs without tools. Even so, bind the opencode server to localhost and set OPENCODE_SERVER_PASSWORD if you expose it. See SECURITY.md.
  • Keep .env and providers.json out of git (both are already in .gitignore).

Roadmap

  • code mode: optional sandboxed test execution (--verify "<cmd>").
  • Panelist tools on the direct backend (a tool-call loop, so non-opencode panels can browse too).
  • Smarter default-panel selection that accounts for model capability, not just family.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openprism-0.2.0.tar.gz (34.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openprism-0.2.0-py3-none-any.whl (33.5 kB view details)

Uploaded Python 3

File details

Details for the file openprism-0.2.0.tar.gz.

File metadata

  • Download URL: openprism-0.2.0.tar.gz
  • Upload date:
  • Size: 34.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for openprism-0.2.0.tar.gz
Algorithm Hash digest
SHA256 5bb8ca5972cccb71eee5b42b53ec9f1429dde0c890ade997709f549829be2507
MD5 6064f624054bef3aa48dba23198a76f8
BLAKE2b-256 f97fa0a9de6a75b61048820030dc6c2f42d748914d0ef518c35b9a7a8cc20f06

See more details on using hashes here.

Provenance

The following attestation bundles were made for openprism-0.2.0.tar.gz:

Publisher: release.yml on ba1lly/OpenPrism

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file openprism-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: openprism-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 33.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for openprism-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 735145cb63f587d2694ca6076ccf773e8cd13ee369af0715bba31645ec83bcaf
MD5 b80af750071dea60f06949cf69c0f4d1
BLAKE2b-256 76f86a94954c2a3a521f1d2d84ee6636e8d4505b1c57b70d25a234f8c7e54f93

See more details on using hashes here.

Provenance

The following attestation bundles were made for openprism-0.2.0-py3-none-any.whl:

Publisher: release.yml on ba1lly/OpenPrism

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page