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.2.0.tar.gz (64.1 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.2.0-py3-none-any.whl (46.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ai_decision_council-1.2.0.tar.gz
  • Upload date:
  • Size: 64.1 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.2.0.tar.gz
Algorithm Hash digest
SHA256 371685b9b8e5d92dfcf021a1988a974a86787dccccacd94219650d3a5373a146
MD5 73a6744a0e2f670c824d3c836eae43dc
BLAKE2b-256 4c90cef46fcb10d1e61ef198291f06e7ddc4bd70fcf506496dcb4aebb9bd5658

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for ai_decision_council-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 58e3176fd3f25fe9b8261e7b77e698aaddd8ea4ef7d12bed1f6038affc639df2
MD5 b973c25b52acec3727cd7c7ffbfc7183
BLAKE2b-256 38b69c951650be9816bbb9233d7ca58cc8eba9745bf2dcca0f2b3be09285db13

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