Consilium is a multi‑agent AI system that simulates founder‑level strategic discussions for evaluating entrepreneurial ideas. Independent, role‑based agents analyze an idea in parallel, and a Chairperson synthesizes their insights into a single, actionable council decision.
Most idea evaluators provide a single perspective. Consilium mirrors how real startup decisions are made — through multiple specialized viewpoints (product, market, tech, finance, risk, growth) and a final synthesis.
This project demonstrates:
- Multi‑agent system design
- Prompt orchestration and synthesis logic
- Backend API architecture using FastAPI
- Practical debugging and production‑safe file handling
Flow:
- User submits an idea
- Seven independent agents evaluate the idea (role‑specific prompts)
- Agent outputs are aggregated internally
- Chairperson synthesizes a final verdict
- API returns a single structured decision
User Idea
↓
[7 Role‑Based Agents]
↓
[Chairperson Synthesis]
↓
Final Council Decision
| Agent | Responsibility |
|---|---|
| Visionary (CEO) | Vision, mission alignment, strategic relevance |
| Product Lead | Problem–solution fit, MVP scope |
| Market Analyst | Market demand, competition, positioning |
| Technology Lead (CTO) | Technical feasibility and scalability |
| Finance Advisor (CFO) | Revenue model, costs, sustainability |
| Risk & Compliance | Legal, operational, execution risks |
| Strategy & Growth | Go‑to‑market and scaling strategy |
Chairperson: Synthesizes all agent outputs into a single recommendation without introducing new analysis.
GET /
Returns API status.
POST /evaluate/{agent_key}
Runs a specific agent by role.
Example agent keys:
- visionary
- product_lead
- market_analyst
- technology_lead
- finance_advisor
- risk_compliance
- strategy_growth
Request Body:
{
"idea": "Your startup idea here"
}POST /evaluate/council
Runs all agents sequentially and returns a synthesized council decision.
Request Body:
{
"idea": "An AI platform that helps college students find paid micro‑internships."
}Response (Example):
{
"council_decision": "Council Verdict: Cautious Go..."
}- Backend: Python, FastAPI
- LLM: OpenAI API (model‑agnostic design)
- Configuration: python‑dotenv
- API Docs: Swagger (OpenAPI)
Consilium/
├── backend/
│ └── app.py
├── prompts/
│ ├── visionary.txt
│ ├── product_lead.txt
│ ├── market_analyst.txt
│ ├── technology_lead.txt
│ ├── finance_advisor.txt
│ ├── risk_compliance.txt
│ ├── strategy_growth.txt
│ └── chairperson.txt
├── README.md
└── PROJECT_CHARTER.md
- Clone the repository
- Create a
.envfile insidebackend/:
OPENAI_API_KEY=your_api_key_here
- Install dependencies
pip install -r backend/requirements.txt
- Start the server
python -m uvicorn backend.app:app
- Open Swagger
http://127.0.0.1:8000/docs
- Multi‑agent orchestration patterns
- Safe prompt loading using absolute paths
- Debugging Python import caching issues
- Designing explainable AI systems
- Parallel agent execution
- Provider toggle (OpenAI / Gemini)
- Frontend UI for idea submission
- Persistent evaluation history
Designed and developed by Arjun R.
This project is intended to demonstrate entrepreneurship‑level system design and applied AI engineering.