Quenvyra logoQuenvyra
Ships as a GitHub container

AI support for Shopify,
grounded in your orders and reviews

Quenvyra is a multi-agent RAG app that answers customer and product-review questions from your own store data. The AI backend and a customizable React front end ship together in one container: light with SQLite, or enterprise with PostgreSQL.

Run it in 2 minutesCompare editions

Everything support needs, in one answer

Stop jumping between the Shopify admin, review apps and policy docs.

Order & customer lookup

Exact match by email or order number, plus natural-language search across orders, tickets and policies.

Product review intelligence

Aggregate reviews into answers: sizing trends, recurring defects and what customers actually say.

Multi-agent RAG

Specialised agents for orders, reviews and knowledge cooperate to ground every answer in your store data.

Answers, not record lists

LLM synthesis turns retrieved context into a direct reply your support agents can send or edit.

Tenant-isolated

Every row and vector carries the shop domain, and every query filters on it.

Hydrogen friendly

Built as a Shopify add-on that works with headless Hydrogen storefronts and webhooks.

Ticket inbox with suggested replies

One click drafts a reply grounded in the order, past tickets and your policies. Agents review and send.

Knowledge base manager

Add, edit and delete policies, FAQs and product docs. Articles are chunked and re-embedded automatically.

Guardrail tester

Probe how the agent handles refund, off-topic and risky requests before customers see it.

Customer widget & admin console

A customizable React + TypeScript front end is bundled in the same container: an embeddable shopper widget (order lookup, ask a question, submit ticket) and a team admin console.

The admin console

Tickets, Knowledge Base, Dashboard, Preferences and Guardrail Test in one place.

TicketsKnowledge BaseDashboardPreferencesGuardrail Test
#4 Want a refund for earbuds
dave@example.com · order 1001
Resolved
#3 Earbuds keep disconnecting from phone
carol@example.com
Open
#1 Watch stopped charging after a week
alice@example.com · order 1003
Open

The client console

A fully customizable, shopper-facing front end built as a TypeScript React + Vite component. Drop it into your Shopify Hydrogen app and style it to your brand.

Order LookupAsk a QuestionSubmit Ticket
Order lookup
Email
Order number
Look up
// app/routes/support.tsx (Hydrogen)
import { QuenvyraWidget } from '@quenvyra/widget'
import '@quenvyra/widget/style.css'

export default function Support() {
  return (
    <QuenvyraWidget
      apiUrl="https://your-host:8000"
      shopDomain="your-shop.myshopify.com"
      tabs={['order', 'ask', 'ticket']}
      theme={{ primary: '#4fbfb0', radius: 12 }}
    />
  )
}
  • TypeScript React component built with Vite, shipped as an npm package and a script bundle
  • Themeable: colors, radius, fonts and copy are all props
  • Order lookup, natural-language questions and ticket submission
  • Talks to the Quenvyra backend you host in Light or Enterprise mode

How it works

Webhooks and knowledge in, grounded answers out.

Shopify webhooks ──▶ API ──▶ SQL store (orders, customers, tickets, reviews)
                                │
Knowledge articles ──▶ chunk ───┤
(policies, FAQs, docs)          ├─▶ Vector store (orders · tickets · knowledge)
                                │
Agent query ──▶ /search/ask ────┴─▶ similarity search ──▶ LLM synthesis ──▶ Answer
Structured

Exact lookups by order number or email.

Semantic

Natural-language search across all sources.

Optional LLM

Works with mock fallbacks until you add an API key.

Light or Enterprise

Same app, same container image. Pick the storage that fits your traffic.

Light

One container, zero infrastructure

  • SQLite system of record
  • Embedded ChromaDB vector store
  • Runs with a single docker command
  • Mock fallbacks without an API key
  • Ideal for single-shop merchants and trials

Enterprise

Scale with PostgreSQL

  • PostgreSQL integration for orders, tickets and knowledge
  • Concurrent multi-merchant traffic
  • Per-tenant authentication on API routes
  • Backups and HA via your Postgres stack
  • Priority support and onboarding

Each license is valid for one Shopify shop.

Quickstart

Pull the image from GitHub Container Registry and run.

Light
docker run -p 8000:8000 -v ./data:/app/data \
  -e OPENAI_API_KEY=sk-... \
  ghcr.io/quenvyra/support-rag:latest
Enterprise (PostgreSQL)
docker run -p 8000:8000 \
  -e DATABASE_URL=postgresql://user:pass@db:5432/quenvyra \
  -e OPENAI_API_KEY=sk-... \
  ghcr.io/quenvyra/support-rag:latest

API on localhost:8000, interactive docs at /docs, admin console at /admin, customer widget at /client.

Embed the widget in your Hydrogen storefront
<script src="https://your-host/widget.js" defer></script>
<quenvyra-widget shop="your-shop.myshopify.com"></quenvyra-widget>

Tuned for your catalog

Bike shops

Deterministic fitment data decides compatibility; the agent explains why a part fits in plain language.

Clothing shops

Fit feedback from reviews and returns becomes sizing guidance and proactive chat on hesitation.

Ready to try Quenvyra?

Tell us about your store and we will help you pick the right edition.