How It Works

Your question goes through a three-stage pipeline:

1. Gather — all council members answer your question in parallel
2. Review — each model blind-reviews the others (anonymized as A, B, C...) and ranks them
3. Synthesize — the chair model reads all opinions + scores and streams a final answer

Models can't see who wrote what, preventing brand-name bias.

Quick Start

npx konsul-ai "What causes inflation?"       # run directly, no install
# or install globally
npm install -g konsul-ai

Set your API key (openrouter.ai — $5 in credits is plenty):

export OPENROUTER_API_KEY=sk-or-v1-...
# or create a .env file in the working directory
echo "OPENROUTER_API_KEY=sk-or-v1-..." > .env

git clone https://github.com/yigityargili991/konsul.git
cd konsul
npm install && npm run build && npm link

Usage

konsul "What causes inflation?"              # balanced preset (default)
konsul --budget "Explain quantum entanglement"
konsul --premium "Compare Rust vs Go"
konsul --serve                               # web UI at localhost:3000
konsul                                       # interactive REPL

Presets

| Flag | Members | Chair | ~Cost | |------|---------|-------|-------| | --free | Hermes 405B, GPT-OSS 120B, Nemotron 120B, Llama 3.3 70B | Trinity Large | $0 | | --budget | DeepSeek V3.2, Gemini Flash Lite, Llama 4 Scout, Mistral Small 4 | DeepSeek V3.2 | $0.002 | | --balanced | DeepSeek V3.2, Gemini Flash, Llama 4 Maverick, GPT-5.4 Mini | Gemini 2.5 Pro | $0.05 | | --premium | Sonnet 4.6, GPT-5.4, Gemini Pro, DeepSeek R1 | Claude Opus 4.6 | $0.30+ |

Custom Councils

konsul --chair opus "Best neuroscience books?"
konsul --members deepseekV3,sonnet,gpt4o --chair opus "Compare React vs Svelte"
konsul --chair xiaomi/mimo-v2-pro "Hello"    # any OpenRouter model ID works
konsul --premium --rounds 3 "Is consciousness computable?"

Interactive Mode

Start with konsul (no arguments). Commands: /tier <name>, /new-team, /web, /verbose, /clear, /quit.

Other Flags

konsul --output result.json "question"       # save full results as JSON
konsul --verbose "question"                  # show individual opinions
konsul --models                              # list available models

Development

npm run dev      # run with tsx (no build step)
npm test         # build + run tests
npm run build    # compile TypeScript → dist/