Getting Started

Sign up at myconsilium.xyz. Authentication is handled by Clerk with support for email, Google, and GitHub sign-in methods. Your account gives you access to the deliberation dashboard, debate history, analytics, and API key management.

Consilium uses a Bring Your Own Keys model. Navigate to Settings and add API keys for the providers you want to use. All keys are encrypted with AES-256-GCM before storage — they are never stored in plaintext or logged. You need at least one provider key, but using 2-3 different providers gives you genuine model diversity in debates.

No keys? Consilium automatically falls back to Groq's free tier models (Llama 3.1 8B, Llama 3.3 70B, Llama 4 Scout) when no paid keys are configured.

Go to the Council page. Enter your topic or question, select a deliberation mode (Council is the default), and choose 2-5 AI models. Click "Start Deliberation" and watch the debate unfold in real-time via Server-Sent Events streaming.

You'll see each phase live: models proposing independently, cross-examining each other, defending their positions, voting, and finally synthesizing a consensus answer.

Every deliberation produces a rich set of outputs:

Export results as Markdown, .cursorrules files, plain text, or copy to clipboard.

npm install -g @myconsilium/cli

Or with yarn/pnpm:

yarn global add @myconsilium/clipnpm add -g @myconsilium/cli

consilium login

Opens your browser for Clerk authentication. On success, a CLI token is stored in ~/.consilium/config.json. Alternatively, set the CONSILIUM_API_KEY environment variable.

pip install consilium

from consilium import ConsiliumClient

client = ConsiliumClient(
    api_url="http://localhost:4000/api/v1",
    api_key="your-api-key"
)

result = client.deliberate(
    topic="Should we migrate from REST to GraphQL?",
    mode="council",
    models=[
        "claude-sonnet-4-6",
        "gpt-5.4",
        "gemini-3-flash-preview"
    ],
    max_rounds=3
)

print(result.golden_prompt)
print(f"Cost: ${result.cost:.4f}")
print(f"Dissent: {result.dissent_report}")

npm install @myconsilium/sdk

import { ConsiliumClient } from "@myconsilium/sdk";

const client = new ConsiliumClient({
  apiUrl: "http://localhost:4000/api/v1",
  apiKey: "your-api-key",
});

const result = await client.deliberate({
  topic: "Should we migrate from REST to GraphQL?",
  mode: "council",
  models: [
    "claude-sonnet-4-6",
    "gpt-5.4",
    "gemini-3-flash-preview",
  ],
  maxRounds: 3,
});

console.log(result.goldenPrompt);
console.log(`Cost: $${result.cost.toFixed(4)}`);