Project Info
VerdictX – Institutional AI Investment Committee
VerdictX is a real-time, multi-agent AI investment committee that researches, debates, and delivers transparent, evidence-backed investment decisions.
Unlike traditional AI assistants that return a single response, VerdictX simulates how institutional investment firms operate. Multiple specialized AI analysts independently research a company, challenge each other's assumptions, update their confidence throughout a live committee discussion, and ultimately produce an institutional-quality investment memo.
Built for the OpenAI Hackathon 2026.
Why VerdictX?
Financial decisions shouldn't rely on one AI generating one answer.
Professional investment firms use committees because diverse perspectives produce stronger decisions.
VerdictX recreates that process with AI.
Every investment request launches six specialized committee members:
- Bull Analyst
- Bear Analyst
- Quantitative Analyst
- Macro Strategist
- Risk Officer
- Chairperson
Each specialist researches independently before entering a moderated committee discussion where they:
- Present evidence
- Challenge other specialists
- Agree or disagree with previous arguments
- Update confidence in real time
- Vote independently
The Chairperson then synthesizes the discussion into a transparent investment recommendation.
Features
- Real-time institutional investment committee
- Multi-agent AI architecture
- Live research streaming
- Turn-by-turn moderated debate
- Dynamic confidence updates
- Institutional investment memo generation
- Financial metrics dashboard
- Evidence-backed reasoning
- Consensus visualization
- Live debate transcript
- Automatic provider failover
- Circuit breaker protection
- Event-driven backend
- Real-time SSE streaming
- Production-ready architecture
Architecture
User
│
▼
Research Engine
│
▼
Financial Data Collection
│
▼
Evidence Packet
│
▼
────────────────────────────────────
Bull Analyst
Bear Analyst
Quant Analyst
Macro Strategist
Risk Officer
────────────────────────────────────
│
▼
Chairperson Moderated Debate
│
▼
Confidence Updates
│
▼
Committee Voting
│
▼
Institutional Memo
Tech Stack
Frontend
- Next.js
- React
- TypeScript
- Tailwind CSS
- Framer Motion
Backend
- FastAPI
- Python
- AsyncIO
- Server-Sent Events (SSE)
AI
- OpenAI GPT-5
- NVIDIA NIM
- OpenRouter (Fallback)
- Multi-Agent Prompt Architecture
Infrastructure
- Vercel
- GitHub
- Event-Driven Architecture
- Circuit Breakers
- Automatic Provider Failover
How It Works
1. Research
VerdictX collects financial information from trusted public sources and builds a structured evidence packet.
Sources include:
- SEC EDGAR
- Yahoo Finance
- Financial statements
- Company fundamentals
2. Independent Analysis
Each specialist receives the evidence packet and independently develops their own thesis.
No analyst simply copies another.
Every role has its own objectives and reasoning framework.
3. Committee Debate
The Chairperson moderates a real committee session.
Specialists:
- defend their opinions
- challenge opposing views
- reference previous arguments
- change confidence when persuaded
- debate until consensus emerges
Every exchange streams live.
4. Consensus
Votes appear individually.
Confidence changes in real time.
Users can watch the committee reach consensus rather than only seeing the final answer.
5. Investment Memo
The Chairperson generates an institutional-quality memo containing:
- Recommendation
- Confidence
- Investment Thesis
- Supporting Evidence
- Risks
- Monitoring Triggers
Real-Time Streaming
VerdictX is fully event-driven.
Instead of waiting for analysis to complete, every stage streams immediately.
Pipeline:
Research
↓
Specialist Analysis
↓
Committee Opening
↓
Live Debate
↓
Confidence Updates
↓
Voting
↓
Memo Generation
↓
Completed Report
Reliability
VerdictX includes production-grade resilience.
- Automatic provider failover
- Circuit breaker protection
- Retry with exponential backoff
- Provider health monitoring
- Session persistence
- Graceful failure handling
If one AI provider becomes unavailable, VerdictX automatically switches providers without interrupting the committee.
What Makes VerdictX Different?
Most AI finance tools:
- One prompt
- One model
- One answer
VerdictX:
- Multiple specialists
- Independent reasoning
- Live committee debate
- Transparent decision making
- Evidence-backed conclusions
- Institutional workflow
It doesn't simply answer.
It explains how the decision was reached.
Challenges
Building VerdictX required solving several difficult engineering problems:
- Designing a real-time streaming architecture
- Coordinating multiple AI specialists
- Synchronizing live frontend updates
- Eliminating fake loading states
- Building provider failover
- Maintaining session consistency
- Streaming debates in chronological order
- Generating institutional-quality memos
What I Learned
Building VerdictX taught me that production AI applications require much more than prompt engineering.
Reliable AI systems depend on:
- streaming architectures
- fault tolerance
- state management
- resilient infrastructure
- transparent reasoning
The biggest lesson was that users trust AI more when they can observe the reasoning process instead of simply receiving a final answer.
Future Roadmap
- Portfolio-level committee analysis
- Earnings call analysis
- SEC filing monitoring
- Multi-company comparison
- Historical backtesting
- Watchlists
- Team collaboration
- Institutional workspaces
- Portfolio optimization
Local Setup
Clone the repository:
git clone https://github.com/YOUR_USERNAME/verdictx.git
cd verdictx
Install frontend dependencies:
npm install
Install backend dependencies:
pip install -r requirements.txt
Create a .env file:
NVIDIA_API_KEY=your_key
OPENROUTER_API_KEY=your_key
CHAIRPERSON_API_KEY=your_key
ENABLE_FAILOVER=true
ENABLE_RETRIES=true
Run the backend:
uvicorn backend.main:app --reload
Run the frontend:
npm run dev
Open:
http://localhost:3000
Project Structure
app/
backend/
components/
lib/
public/
prompts/
schemas/
providers/
README.md
package.json
requirements.txt
Built With
- OpenAI
- GPT-5
- FastAPI
- Next.js
- React
- TypeScript
- Python
- Tailwind CSS
- Framer Motion
- Server-Sent Events
- AsyncIO
- NVIDIA NIM
- OpenRouter
- Vercel
AI Development Workflow
VerdictX was developed using GPT-5.6 and Codex as collaborative engineering tools throughout the project lifecycle.
GPT-5.6
GPT-5.6 was used as the primary design and architecture partner. It assisted with:
- Designing the multi-agent institutional investment committee architecture
- Iterating on system design, backend architecture, and frontend UX
- Refining specialist prompts and debate workflows
- Planning the real-time streaming experience
- Reviewing implementation decisions and identifying architectural improvements
- Debugging complex backend, frontend, and event-driven issues
- Writing technical documentation, README content, and project descriptions
- Improving production readiness and deployment strategy
Rather than generating isolated snippets of code, GPT-5.6 was used throughout the project to iteratively design, review, and improve the system from initial concept to final implementation.
Codex
Codex accelerated implementation by performing repository-aware engineering tasks, including:
- Refactoring large sections of the frontend and backend
- Building and modifying React, Next.js, and FastAPI components
- Implementing the real-time SSE event pipeline
- Updating multi-agent orchestration logic
- Refactoring schemas and event models
- Implementing provider failover and circuit breaker logic
- Running project-wide code analysis
- Fixing TypeScript and Python errors
- Verifying builds, linting, and production readiness
- Preparing the project for deployment and submission
Codex was used as an engineering assistant to automate repetitive implementation work while preserving the intended architecture and functionality.
Human Contribution
The overall concept, product vision, user experience, committee workflow, feature prioritization, system architecture, prompt iteration, testing, debugging decisions, and final design direction were conceived, directed, and validated by the project author. AI tools were used to accelerate software engineering and implementation while keeping human oversight throughout the development process.
Acknowledgements
Built for the OpenAI Hackathon 2026.
Inspired by institutional investment committees used by hedge funds, venture capital firms, and investment banks, combined with modern multi-agent AI systems.
License
MIT License
VerdictX
Research. Debate. Decide.
Analysis
View
Metric
- 7
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- FastAPIIn code
- Next.jsIn code
- OpenAIIn code
- PythonIn code
- ReactIn code
- Tailwind CSSIn code
- TypeScriptIn code
- VercelClaimed
8 of 9 appear in the indexed code. 1 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
944 KB
Source files
146
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
raj-k21/VerdictX
155 files · 1.5 MB · @ 9c9370b
Structure
Interface
83 files · 54%Screens, components and styles rendered to the user.
+3 moreAPI & routing
5 files · 3%Request entry points: routes, handlers and controllers.
Application logic
36 files · 23%Domain rules, services and shared utilities.
+3 moreData & schema
5 files · 3%Schema definitions, migrations and data access.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- TypeScript66%
- Python26%
- Markdown4%
- CSS3%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
package.json
npm · 23- @react-three/drei
- @react-three/fiber
- @types/node
- @types/react
- @types/react-dom
- @types/three
- framer-motion
- jspdf
- leva
- lucide-react
- next
- react
- react-dom
- react-markdown
- recharts
- remark-gfm
- three
- typescript
- +5 more
backend/requirements.txt
pypi · 6- fastapi
- httpx
- openai
- pydantic-settings
- python-dotenv
- uvicorn[standard]
Declared in the repository’s manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
This project’s features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.