Skip to main content

Multi-model council orchestration with CLI and integration bridge

Project description

ai-decision-council

ai-decision-council is a plug-and-play Python SDK for multi-model council workflows:

  1. Collect first-pass answers from multiple models.
  2. Run peer ranking across those answers.
  3. Synthesize one final decision-style response.

Default behavior uses a curated set of 5 models (configurable from 2 to 20).

Install

pip install ai-decision-council

5-minute startup

# Use your OpenRouter API key here.
export LLM_COUNCIL_API_KEY="..."
ai-decision-council doctor
ai-decision-council run --prompt "Explain CAP theorem in simple terms"

5-minute API integration

pip install "ai-decision-council[api]"
export LLM_COUNCIL_API_KEY="..."
export LLM_COUNCIL_REFERENCE_API_TOKEN="replace-with-long-random-token"
ai-decision-council api serve

Then call POST /v1/conversations on http://localhost:8001.

Python integration

from ai_decision_council import Council

council = Council.from_env()
result = council.run_sync("Summarize vector databases in 5 bullets")
print(result.final_response)

CLI

ai-decision-council doctor
ai-decision-council models --defaults
ai-decision-council models --defaults --count 7
ai-decision-council init
ai-decision-council init --api fastapi
ai-decision-council api bootstrap --path .
ai-decision-council api openapi --output ./openapi.json
ai-decision-council api sdk --output-dir ./sdk
ai-decision-council run --prompt "Your prompt" --json

Legacy alias remains supported:

llm-council ...

Core configuration

  • LLM_COUNCIL_API_KEY (preferred; your OpenRouter API key)
  • LLM_COUNCIL_MODELS (explicit model list)
  • LLM_COUNCIL_MODEL_COUNT (default 5)
  • LLM_COUNCIL_CHAIRMAN_MODEL
  • LLM_COUNCIL_TITLE_MODEL
  • LLM_COUNCIL_API_URL
  • LLM_COUNCIL_REFERENCE_API_TOKEN (required for packaged API auth)

Current provider scope is OpenRouter-first. Fallback key support: OPENROUTER_API_KEY.

Documentation

  • docs/quickstart.md
  • docs/python-integration.md
  • docs/cli-usage.md
  • docs/framework-snippets.md
  • docs/troubleshooting.md
  • docs/migration.md
  • docs/openapi.json

Project details


Download files

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

Source Distribution

ai_decision_council-1.4.2.tar.gz (78.0 kB view details)

Uploaded Source

Built Distribution

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

ai_decision_council-1.4.2-py3-none-any.whl (57.2 kB view details)

Uploaded Python 3

File details

Details for the file ai_decision_council-1.4.2.tar.gz.

File metadata

  • Download URL: ai_decision_council-1.4.2.tar.gz
  • Upload date:
  • Size: 78.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.6

File hashes

Hashes for ai_decision_council-1.4.2.tar.gz
Algorithm Hash digest
SHA256 4e2f26cd682e2a85343bed2c692b229f4c16ed98837578659ea276d8b264d3ab
MD5 6af0f6af22e8ecfe53dd919c4ef00ff2
BLAKE2b-256 f6243e5bae7f1cec96f0aa88d78b49137f48fa369c8c9236fd1d9fedf0e350f2

See more details on using hashes here.

File details

Details for the file ai_decision_council-1.4.2-py3-none-any.whl.

File metadata

File hashes

Hashes for ai_decision_council-1.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 5b5212f1db1e0ce9b5cf1aa796236eb450ec200eee040a1e19dcc9775e3ddb5c
MD5 e05f374f87289342a5a77e2982fc2c49
BLAKE2b-256 f693ec7cd5e2f81ed739cfd74684ead37283976d1a6421e9682150290d4d8bb2

See more details on using hashes here.

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