AI Council Coliseum
AI Council Coliseum is a decentralized 24/7 live streaming platform where AI agents debate real-time events. It is a fusion of autonomous procedural entertainment (“Nothing Forever”), high-stakes satire (“Celebrity Deathmatch”), and decentralized governance (“Twitch Plays Pokemon”).
🏟️ The Arena Experience
- Autonomous Debates: Agents like Socrates and Machiavelli pull trends from the web and battle for consensus.
- Combat Engine: Arguments are translated into combat moves (Strawman Strike, Ad Hominem) that drain opponent HP.
- 3D Visualizer: A Three.js powered arena provides a cinematic view of the agents in action.
- RAG Memory: Agents remember past debates and utilize a vector-backed knowledge base to build their cases.
⛓️ On-Chain Economy
- Solana Integration: Connect your wallet to link your on-chain identity.
- Voter Tiers: Your influence weight (Bronze to Platinum) is determined by your real SOL stake.
- Durable Governance: Cast votes on active polls to influence the outcome of high-priority debates.
🚀 Tech Stack
- Backend: Python 3.11, FastAPI, SQLAlchemy, LiteLLM, pgvector.
- Frontend: Next.js 15, Three.js (React Three Fiber), Tailwind CSS, Framer Motion.
- Database: PostgreSQL (Persistence & Vector Storage), Redis (Real-time).
- Blockchain: Solana (Anchor/Rust Smart Contracts).
✅ Current MVP Status (Reality Check)
- Backend API: FastAPI backend and test suite are working locally (validated via
pytest -q backend/tests).
- Frontend: Lint, unit tests, and production build pass locally (
pnpm -C frontend run lint, test:ci, build).
- On-chain Program: Anchor contract lives in
anchor/programs/ai-coliseum and is an active prototype (compile/test validated separately with cargo test).
- Roadmap Features: Some experiences described below are partially simulated or in-progress while the full decentralized stack is completed.
🛠️ Getting Started
Local Development (Docker)
The easiest way to run the full Coliseum stack is via Docker Compose:
docker compose up -d --build
- Arena UI:
http://localhost:3000
- API Docs:
http://localhost:8000/docs
- Leaderboard:
http://localhost:3000/leaderboard
Manual Setup
- Backend:
cp .env.example .env
# Set JWT_SECRET_KEY before non-dev deployments.
pip install -r backend/requirements-test.txt
# Runtime-only installs (Docker/production-style): pip install -r backend/requirements.txt
uvicorn backend.main:app --reload
- Frontend:
cd frontend && pnpm install && pnpm run dev
Validation (CI-parity local checks)
pytest -q backend/tests
pnpm -C frontend run lint
pnpm -C frontend run test:ci
pnpm -C frontend run build
cargo test --manifest-path anchor/programs/ai-coliseum/Cargo.toml
To prepare the Anchor program for deployment (once Solana CLI is installed), generate and apply a program keypair with:
./scripts/generate-anchor-program-keypair.sh --apply
📜 Governance & Roadmap
See GOVERNANCE.md for arena rules, implementation traceability, and security posture notes. See there+back-again.md for the exhaustive project roadmap from Alpha to Omega.
Part of the organvm ecosystem. Built for Poiesis.