Skip to content

HilaryOkello/whichbid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WhichBid Logo

🤖 AI-Powered Quote Comparison for Smarter Procurement

Upload vendor quotes → Get instant AI analysis → Make confident decisions

Next.js FastAPI AI TypeScript


🎯 What is WhichBid?

WhichBid is an AI agent that helps small businesses analyze and compare vendor quotes instantly. No more spreadsheets or manual calculations—just upload your quotes and let AI do the work.

💡 Why WhichBid?

Problem Solution
Comparing quotes is time-consuming AI analyzes in seconds
Hidden costs are easy to miss AI detects hidden fees automatically
Decision-making is subjective Data-driven recommendations with scores

⚡ Quick Start

# Backend (Terminal 1)
cd whichbid && poetry install && cp .env.example .env
# Add your OpenRouter API key to .env
poetry run uvicorn main:app --reload

# Frontend (Terminal 2)
cd whichbid-ui && npm install && npm run dev

Openlocalhost:3000


✨ Features

Feature Description
📄 Multi-Quote Analysis Upload 2+ PDF/DOCX quotes for comparison
🏆 Smart Ranking AI scores vendors (0-100) based on your priorities
⚠️ Hidden Cost Detection Automatically finds fees buried in fine print
📊 Savings Dashboard Animated metrics show potential savings at a glance
📜 Analysis History Revisit past comparisons stored locally
🌓 Dark/Light Mode Toggle theme with one click
📋 Quick Share Copy professional summary to share with stakeholders
📥 PDF Export Download detailed analysis reports

🧪 Test the Features

  1. Upload → Drag 2-3 sample quote PDFs
  2. Customize → Set priorities (price, timeline, quality)
  3. Analyze → Click "Compare Quotes" and watch the magic
  4. Explore Results → Check the Savings Dashboard metrics
  5. Share → Click "Share Summary" to copy results
  6. Toggle Theme → Try the sun/moon button in header
  7. View History → Run another analysis, then check History dropdown

🛠️ Tech Stack

Frontend  →  Next.js 16 • React • TypeScript • Tailwind CSS
Backend   →  Python • FastAPI • Poetry
AI        →  OpenRouter API (Claude/GPT models)

📁 Project Structure

whichbid/          # Backend API
whichbid-ui/       # Frontend App

Built with ❤️ for the AI Hackathon 2026

About

A AI agent that helps small businesses analyse quotes from different vendors

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors