kummethachandrikareddy2006-byte/paypilot-ai

How kummethachandrikareddy2006-byte/paypilot-ai works

PayPilot is a local-first shopping assistant: a shopper enters a natural-language request, receives ranked and explained catalog matches, stages a cart, and explicitly confirms a local test order. The FastAPI application owns the API routes and in-memory cart; recommendation logic and catalog access are separate concerns, while order records persist in SQLite. The README also documents product browsing/comparison, cart management, order lookup, and payment routes. Some source excerpts are partial, so uncertain implementation links are omitted or shown as unverified.

Main entry points: main.py FastAPI routes · index.html Browser UI · agent.py Intent extraction · product_engine.py Catalog access

Components 12

Shopping experience

Browser UI frontend/index.html
FastAPI routes backend/main.py

Recommendations

Intent extraction backend/agent.py
Scoring and explanations backend/agent.py
Catalog access backend/product_engine.py
Seeded catalog data/products.csv

Commerce operations

Cart operations backend/main.py
Checkout and order placement backend/main.py
Test payment result backend/payment.py
Order lookup and status backend/main.py

Local data

SQLite order store database/db.py

Other components

Shopper

Connections 14

Shopper → Browser UI: submits request README.md
Browser UI → FastAPI routes: calls API README.md
FastAPI routes → Intent extraction: invokes agent backend/main.py
Intent extraction → Scoring and explanations: scores matches README.md
Scoring and explanations → Seeded catalog: searches catalog README.md
FastAPI routes → Catalog access: looks up products backend/main.py
Catalog access → Seeded catalog: reads CSV backend/product_engine.py
FastAPI routes → Cart operations: manages cart backend/main.py
Shopper → Checkout and order placement: confirms order README.md
FastAPI routes → Checkout and order placement: handles checkout backend/main.py
Checkout and order placement → SQLite order store: saves order backend/main.py
FastAPI routes → Order lookup and status: serves order routes backend/main.py
Order lookup and status → SQLite order store: reads and updates backend/main.py
FastAPI routes → Test payment result: uses payment helper backend/main.py

Drawn by GitDiagram on November 10, 2026 from the repository's file tree, README and source files. Read as Markdown ·