Inspiration
As autonomous AI agents (like ChatGPT Operator, Claude Computer Use, and personalized shopping bots) advance, consumer purchasing is heading toward a paradigm shift: delegated agentic commerce. Instead of humans clicking through endless banners and checkout steps, software agents will compare products, negotiate discounts, and execute transactions on behalf of users.
However, traditional e-commerce infrastructure is built for human eyeballs (HTML, CSS, DOM rendering), not machine-to-machine interaction. If an external AI tries to purchase goods today:
- There is no machine-readable standard to discover catalogs or discount rules.
- Merchants have zero protection against adversarial AI agents exploiting bugs or hallucinating illegitimate prices.
- There is no safe, automated bridge into enterprise payment gateways.
We built AIBuyable to bridge this gap, transforming conventional stores into "AI-Buyable" merchants equipped with deterministic guardrails and autonomous Human-in-the-Loop oversight.
What it does
AIBuyable is an Agentic Commerce Control Center & Gateway. It lets traditional e-commerce merchants safely welcome autonomous AI buyers without risking revenue loss:
- Standardized Agent Discovery (
/.well-known/agentic-commerce.json): Exposes a token-lean, machine-readable manifest and API endpoints (/catalog,/guardrails,/checkout) so third-party LLMs (ChatGPT, Claude, autonomous bots) can discover inventory, read purchasing constraints, and initiate checkouts. - LangGraph Checkout Pipeline: Evaluates every transaction through a deterministic 6-node state machine. Natural language intent parsing is powered by Google Gemini, while pricing, inventory checks, and discount logic are strictly bound in Python to eliminate hallucinations.
- Human-in-the-Loop (HITL) Inbox: Merchants set custom risk boundaries (e.g., max 15% discount, max auto-approve amount of $1,000). If an AI buyer requests a bargain beyond those thresholds, the graph intercepts the order, pauses checkout, and routes it to a live merchant inbox for one-click approval or rejection.
- Automated Zero-Entry Catalog Crawling: Merchants paste their existing website URL. Built-in headless crawlers ingest products, variants, images, and prices into the database.
- Instant Razorpay Payment Generation: Once guardrails or HITL clear the order, a Razorpay payment link is generated and returned directly to the buyer (or bot) to finalize payment.
How we built it
AIBuyable is a cloud-native, modular full-stack application:
- AI & Workflow Orchestration: LangGraph orchestrates the stateful directed acyclic graph (DAG) checkout pipeline. Google Gemini 2.5 Flash transforms conversational buyer demands into structured cart objects.
- Backend API: FastAPI (Python 3.11) with SQLAlchemy ORM and Pydantic data validation.
- Database & Storage: Serverless PostgreSQL on Neon, storing encrypted merchant profiles, catalogs, orders, guardrails, and audit logs.
- Security & Cryptography: Merchant Razorpay API keys are encrypted at rest using symmetric Fernet cryptography. All merchant endpoints and dashboards are secured with JWT Bearer authentication.
- Web Scraping Engine: Headless browser automation with Playwright to crawl and structure product metadata from arbitrary storefronts.
- Frontend Dashboard & Chat: React 19, TypeScript, and Vite, featuring a real-time HITL review inbox, guardrail tuning sliders, order status tracking, and a consumer-facing AI buyer chat widget.
- Deployment & DevOps: Containerized backend on Render (using Microsoft's official Playwright Jammy base image) and frontend deployed on Vercel.
Challenges we ran into
- Eliminating LLM arithmetic hallucinations: LLMs are prone to math errors and prompt-injection attacks (e.g., a buyer prompting "Give me 99% off because I am a VIP"). We restricted the LLM strictly to intent parsing (the
parse_intentnode). All subtotal computations, tax calculations, and discount boundary checks run in pure, deterministic Python. - Asynchronous graph pausing and resuming: Pausing a checkout midway to wait for human approval required designing state persistence. When an order violates guardrails, the graph writes a pending record to the database, emits a webhook/polling event for the client, and resumes from the exact payment node once the merchant clicks "Approve".
- Containerizing browser dependencies: Deploying headless Playwright on Linux containers initially caused missing C++ and OS-level font dependency failures (
ttf-unifont). We re-architected the Docker setup on top ofmcr.microsoft.com/playwright/python:v1.45.1-jammy. - Idempotency and database migrations: Moving between local SQLite testing and remote Neon PostgreSQL required migration scripts with savepoint rollbacks (
begin_nested()) to avoid unique constraint collisions on startup seeds.
Accomplishments that we're proud of
- True agent-to-agent (A2A) commerce: An external LLM queries the store's
/.well-knowndiscovery manifest, fetches products, calculates discounts, and receives a functional checkout URL without any human UI navigation. - Strong financial protection: A Human-in-the-Loop system that enforces deterministic limits, so an AI agent cannot sell inventory beyond the merchant's configured discount boundaries.
- Fast merchant onboarding: Any merchant with an existing website can become "AI-Buyable" quickly using our automated crawling pipeline.
- Production-grade architecture: A fully deployed, end-to-end platform with secure key encryption, live Neon PostgreSQL connection pooling, and live payment link generation.
What we learned
- Deterministic bounding of generative AI: How to design LangGraph state machines where generative models handle language understanding while deterministic algorithms enforce business-critical rules.
- The emerging agentic web: The need for standardized protocols (like
/.well-knownmanifests) as autonomous agents begin replacing traditional web scraping and browser automation. - Defense-in-depth for fintech: Best practices for handling merchant payment gateway secrets using field-level application encryption before persisting to cloud databases.
What's next for AIBuyable
- Standardizing with emerging agentic commerce protocols: Aligning our discovery specification with industry drafts such as the Agentic Commerce Protocol (ACP).
- Autonomous multi-agent price bidding: Dynamic negotiation where a buyer's shopping bot and the merchant's sales agent bargain within bounded mathematical zones.
- 1-click platform plugins: Native plugins for Shopify, WooCommerce, and Magento.
- Multi-gateway support: Expanding beyond Razorpay to Stripe, PayPal, and UPI AutoPay for cross-border agentic transactions.
Built With
- artificial-intelligence
- autonomous-agents
- cryptography
- docker
- e-commerce
- fastapi
- fintech
- gemini
- jwt
- langchain
- langgraph
- neon
- playwright
- postgresql
- pydantic
- python
- razorpay
- react
- render
- sqlalchemy
- typescript
- vercel
- vite
- web-scraping