# Project export: Verdict AI This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small. ## Project metadata - Hackathon: OpenAI Build Week - Tagline: An explainable AI decision support system that reviews evidence, explains its reasoning, highlights uncertainty, and helps humans make better decisions with GPT-5.6 - Devpost: https://devpost.com/software/verdict-ai-5wj1ft - GitHub: https://github.com/aadityakulkarni12-cell/Verdict-AI - Demo: https://verdict-ai-seven.vercel.app/ - Video: https://www.youtube.com/embed/_A59Dwg_X_c?enablejsapi=1&hl=en_US&rel=0&start=&version=3&wmode=transparent - Team: 1 GitHub contributor(s) — Aaditya Hemant Kulkarni (8 commits) ## Devpost submission (written by the team) ### Inspiration As AI systems become more capable, I believe they'll play a much larger role in helping people make important decisions. Whether it's software deployments, connected vehicles, manufacturing, healthcare, or finance, the amount of data available is growing much faster than a person can manually analyze. That led me to a simple question: How can AI help people make better decisions without becoming a black box? Verdict AI was built to explore that future. Instead of replacing human judgment, it reviews structured evidence, explains its reasoning, highlights uncertainty, and recommends the next best action while keeping a human in control of the final decision. ### What it does Verdict AI is an explainable AI decision support system. It collects evidence from multiple sources, validates it, sends structured information to GPT-5.6 for reasoning, calculates confidence, and returns a transparent recommendation together with its assumptions and missing evidence. The same reasoning pipeline can be applied across multiple domains. The current demonstration includes: Software deployment investigations Connected vehicle investigations Manufacturing anomaly investigations The goal is not anomaly detection itself, but transparent AI-assisted decision making. ### How we built it Verdict-AI consists of a React + TypeScript frontend and a FastAPI backend connected through the OpenAI Responses API. The backend normalizes evidence, performs deterministic validation, invokes GPT-5.6 to generate structured reasoning, validates the response, calculates confidence, and produces recommendations. If AI is unavailable, the system automatically falls back to a deterministic decision engine to ensure reliability. Codex played a significant role throughout development by helping accelerate implementation, debugging, refactoring, documentation, and repository organization. ### Challenges we ran into The biggest challenge wasn't implementing GPT-5.6, it was turning an idea into a product. I didn't want to build another AI demo that simply generated answers. I wanted Verdict AI to feel like a real decision-support system with a clear user experience, explainable reasoning, confidence scoring, and human oversight. Finding the right balance between automation and transparency took the most iteration. I wanted every recommendation to remain connected to the evidence that produced it, allowing users to understand not only the conclusion, but also its assumptions, uncertainty, and limitations. ### Accomplishments we're proud of I'm proud that Verdict AI demonstrates a complete end-to-end workflow rather than just an AI prompt. The project combines a production-style frontend, a FastAPI backend, GPT-5.6 reasoning through the OpenAI Responses API, deterministic fallback behavior, explainable recommendations, confidence scoring, and a polished user experience into a single application. Most importantly, it reinforces the idea that AI should help people make better decisions, not replace them. ### What we learned Building Verdict-AI reinforced that the most valuable AI products aren't necessarily those that automate everything. People are more likely to trust AI when it explains its reasoning, communicates uncertainty, and keeps humans involved in important decisions. I also gained a much deeper understanding of designing AI systems that combine deterministic software engineering with large language models in a reliable and transparent way ### What's next Verdict AI is currently a proof of concept, but I see it evolving into a production-ready decision support platform. The next step is to pilot this approach within real enterprise workflows, where AI can assist teams in reviewing evidence, explaining its reasoning, and recommending the next best action while keeping humans responsible for the final decision. I also want to expand the platform beyond the current software, automotive, and manufacturing scenarios by integrating live data sources, richer evidence pipelines, role-based collaboration, audit trails, and feedback loops that continuously improve recommendations over time. Ultimately, my goal is to build AI systems that people can trust, not because they always have the right answer, but because they clearly explain how they reached it and make it easy for humans to make informed decisions. ## README (from the GitHub repository) No README available. ## Detected evidence (automated analysis) Indexed codebase: 64 recognized source files, 146 KB. - CSS (language) — detected in the code - FastAPI (technology) — detected in the code - HTML (language) — detected in the code - JavaScript (language) — detected in the code - OpenAI (technology) — detected in the code - Python (language) — detected in the code - React (technology) — detected in the code - Tailwind CSS (technology) — detected in the code - TypeScript (language) — detected in the code - Vercel (technology) — claimed on Devpost, not found in the code ## Codebase structure (from repository index) ### Files (75 of 75) ``` .github/workflows/ci.yml .gitignore AI_JUDGE.md ARCHITECTURE.md backend/.env.example backend/app/__init__.py backend/app/config/__init__.py backend/app/config/settings.py backend/app/decisions/__init__.py backend/app/decisions/ai_judge.py backend/app/decisions/confidence.py backend/app/decisions/judge.py backend/app/decisions/models.py backend/app/decisions/recommendation.py backend/app/evidence/__init__.py backend/app/evidence/models.py backend/app/evidence/normalizer.py backend/app/main.py backend/app/models/__init__.py backend/app/models/common.py backend/app/orchestrator/__init__.py backend/app/orchestrator/engine.py backend/app/orchestrator/evaluators.py backend/app/orchestrator/interfaces.py backend/app/orchestrator/planner.py backend/app/routers/__init__.py backend/app/routers/decisions.py backend/app/routers/evaluation.py backend/app/routers/health.py backend/app/sample_data/__init__.py backend/app/sample_data/decisions.py backend/app/services/__init__.py backend/app/services/decision_service.py backend/index.py backend/pytest.ini backend/requirements-dev.txt backend/requirements.txt backend/tests/conftest.py backend/tests/test_ai_judge.py backend/tests/test_api.py backend/tests/test_decision_engine.py DECISION_ENGINE.md frontend/.env.example frontend/index.html frontend/package.json frontend/postcss.config.js frontend/src/App.tsx frontend/src/components/investigation/DecisionOverview.tsx frontend/src/components/investigation/HowAIDecides.tsx frontend/src/components/investigation/InvestigationSequence.tsx frontend/src/components/investigation/InvestigationTimeline.tsx frontend/src/components/investigation/ScenarioPicker.tsx frontend/src/components/layout/AppLayout.tsx frontend/src/components/layout/Header.tsx frontend/src/components/layout/Sidebar.tsx frontend/src/components/PageHeading.tsx frontend/src/components/StatusBadge.tsx frontend/src/lib/api.ts frontend/src/main.tsx frontend/src/pages/DecisionsPage.tsx frontend/src/pages/EvidenceInputPage.tsx frontend/src/pages/SettingsPage.tsx frontend/src/sample_data/decisions.ts frontend/src/sample_data/scenarios.ts frontend/src/styles/index.css frontend/src/types/decision.ts frontend/src/types/scenario.ts frontend/src/vite-env.d.ts frontend/tailwind.config.js frontend/tsconfig.app.json frontend/tsconfig.json frontend/tsconfig.node.json frontend/vercel.json frontend/vite.config.ts README.md ``` ### Dependencies - backend/requirements.txt: fastapi@==0.115.12, openai@==2.45.0, pydantic-settings@==2.9.1, uvicorn[standard]@==0.34.2 - frontend/package.json: @types/react@18.3.18, @types/react-dom@18.3.5, @vitejs/plugin-react@4.3.4, autoprefixer@10.4.20, lucide-react@0.468.0, postcss@8.5.19, react@18.3.1, react-dom@18.3.1, react-router-dom@7.18.1, tailwindcss@3.4.17, typescript@5.7.2, vite@6.4.3 ### Recent commits (newest first) - docs: improve Verdict-AI project README - Update README.md - Update README.md - Connect frontend to live AI judge - Add progressive AI investigation experience - Reframe frontend as AI investigation workflow - Fix Vercel backend dependency detection - Prepare Verdict-AI for Vercel deployment ## Key source files (fetched from GitHub, selected and truncated for size) Source contents could not be fetched from GitHub right now. [65 more indexed source files omitted to keep this export small. The full file list is in the Codebase structure section above.]