piyushjha0409/quickart

How piyushjha0409/quickart works

QuickCart is a customer-support agent for quick-commerce orders, delivery issues, refunds, disputes, and policy questions. A customer uses the chat UI and API; the server supplies demo customer context and invokes a LangGraph agent, which chooses model responses and tools. Tools read order data, retrieve policy, and record actions; gated work enters a human review queue. PostgreSQL holds operational and knowledge-base data. The README also describes evaluation and production-monitoring goals, but no corresponding runtime subsystem appears in the provided tree. Edges reflect shown calls or documented relationships; unsampled subsystems are not inferred.

Main entry points: server.py HTTP API · node.py LLM and tools · tools.py Order and action tools · main.py Agent workflow

Components 18

Customer interface

Chat UI src/quickcart/web/app.js
HTTP API src/quickcart/server.py

Agent runtime

Agent workflow src/quickcart/main.py
LLM and tools src/quickcart/node.py
Support policy prompt src/quickcart/prompts.py
Model selection src/quickcart/models.py

Support capabilities

Tool registry src/quickcart/init.py
Order and action tools src/quickcart/tools.py
Policy retrieval src/quickcart/knowledge.py
Human review src/quickcart/reviews.py

Data and policy

PostgreSQL
Data models src/quickcart/db/models.py
Database setup src/quickcart/db/init.py
Demo data src/quickcart/db/seed.py
Knowledge ingestion src/quickcart/ingest_kb.py
Policy pages kb

Other components

Customer
OpenAI models

Connections 24

Customer → Chat UI: starts chat README.md
Chat UI → HTTP API: sends chat README.md
HTTP API → Agent workflow: invokes src/quickcart/server.py
HTTP API → Model selection: selects effort src/quickcart/server.py
HTTP API → Human review: routes review src/quickcart/server.py
HTTP API → Database setup: creates tables src/quickcart/server.py
Agent workflow → LLM and tools: runs nodes src/quickcart/main.py
Agent workflow → Demo data: uses demo user src/quickcart/main.py
Agent workflow → Order and action tools: loads context src/quickcart/main.py
LLM and tools → Support policy prompt: builds prompt src/quickcart/node.py
LLM and tools → Model selection: selects model src/quickcart/node.py
LLM and tools → Tool registry: runs tools src/quickcart/node.py
LLM and tools → Order and action tools: escalates src/quickcart/node.py
Model selection → OpenAI models: calls src/quickcart/models.py
Tool registry → Policy retrieval: registers src/quickcart/init.py
Tool registry → Order and action tools: registers src/quickcart/init.py
Order and action tools → PostgreSQL: reads and writes src/quickcart/tools.py
Order and action tools → Human review: notifies src/quickcart/tools.py
Policy retrieval → PostgreSQL: searches vectors src/quickcart/knowledge.py
Human review → PostgreSQL: reads and updates src/quickcart/reviews.py
Database setup → Data models: creates tables src/quickcart/db/init.py
Database setup → PostgreSQL: connects src/quickcart/db/init.py
Demo data → Data models: creates records src/quickcart/db/seed.py
Knowledge ingestion → PostgreSQL: stores chunks src/quickcart/ingest_kb.py

More Python diagrams: tensortrade-org/tensortrade · prefecthq/marvin · bytedance/megatts3 · cloud-custodian/cloud-custodian · mai-with-u/maibot

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