LLM Parliament
Multi-agent debate for better AI decisions. Research-backed, local-first.
Three AI models debate your question through a parliamentary process: First Reading, Debate, and Division. The result is a structured verdict with consensus, split views, risks, and a recommendation.
Built on multi-agent debate, a technique shown to improve AI accuracy by 7-15% in research (Liang et al. 2023, Chen et al. 2023).
See CHANGELOG.md for the release history.
---
👋 This is my GitHub and developer debut! llm-parliament is the first project I've shipped publicly. I built it to learn, and I'd genuinely love your help making it better. Feedback, bug reports, feature ideas, code review, and pull requests are very welcome — no contribution is too small. If something feels confusing, doesn't install, breaks on your terminal, or could be more polished, please open an issue or say hi in Discussions. Concrete places to start: good first issues · help wanted · roadmap · CONTRIBUTING.md Stars also help me see what's resonating. Thanks for taking a look. 🙏
---
Quick Start
pipx install llm-parliament
parliament doctor
parliament # opens the TUIThe mock parliament runs out of the box with no setup.
Installation
The recommended way is pipx — it installs the tool into an isolated environment but exposes parliament globally on your PATH, so you don't have to think about virtual environments.
Linux
# Prereqs (one-time)
sudo apt install pipx # Debian/Ubuntu — or `pacman -S python-pipx`, `dnf install pipx`
pipx ensurepath # adds ~/.local/bin to PATH
# Restart your shell.
# Install
pipx install llm-parliament
# Verify
parliament doctormacOS
# Prereqs (one-time)
brew install pipx
pipx ensurepath
# Restart your shell.
# Install
pipx install llm-parliament
# Verify
parliament doctor