Turn WhatsApp chats into paid orders. Automatically. VendorMind gives your business a 24/7 AI sales agent (Zinc) that lives inside WhatsApp. It answers customer questions, recommends products, manages carts, and collects payments via BMONI Smart Wallets - while you focus on running your business.
- Zinc AI Sales Agent: Natural product recommendations, context-aware memory, store policy answers, and Pidgin/English multi-lingual support powered by Groq Llama 3.3 70B & Claude 3.5 Sonnet.
- BMONI cNGN Smart Wallet: Native in-chat cNGN payments, instant NGN virtual bank accounts for customers, and direct bank offramps without external redirect loops.
- Voice Commerce: Automatic transcription of customer audio voice notes powered by Groq Whisper Turbo.
- Smart Cart & 30-Min Soft Lock: In-chat shopping cart state, automated total calculations, and 30-minute inventory reservations during checkout.
- Product Image Grid & Uploads: Rich catalog view with product image URLs, upload previews, and fallback avatar generators.
- pgvector Semantic Search: High-accuracy cosine similarity product search (OpenAI 1536-dim embeddings) for natural customer descriptions.
- AI Business Advisor: Morning plain-English business briefings, 24-hour revenue snapshots, and interactive data Q&A.
- Smart Customer Classifier: Differentiates commercial inquiries from casual friend chit-chat to stand down automatically and conserve API usage.
- Human Handoff & Reconnect Guards: One-tap human takeover, dashboard notifications, and WhatsApp socket reconnect timestamp guards against message floods.
- Complete Marketing & Legal Suite: Full word-for-word pages for /about, /privacy, /terms, /help (searchable FAQ), /contact (interactive desk), /how-it-works, /features, /pricing, and /blog.
| Layer | Technology |
|---|---|
| Runtime & Package Manager | Bun (>= 1.1.0) |
| WhatsApp Engine | Baileys (@whiskeysockets/baileys) multi-device sockets |
| API Gateway | Fastify |
| Database & Vector Storage | PostgreSQL 15 + pgvector extension |
| ORM & Migrations | Prisma ORM |
| LLM Inference | Groq (llama-3.3-70b-versatile) + Anthropic Claude (claude-3-5-sonnet) |
| Voice Processing | Groq Whisper Turbo |
| Payments & Wallets | BMONI Smart Wallet (cNGN + NGN Virtual Accounts) |
| Frontend App | React + Vite + Tailwind CSS + Lucide Icons + PWA (Firebase Hosting) |
| Smooth Animations | Lenis + Framer Motion |
- Bun (v1.1+)
- PostgreSQL 15+ with
pgvectorextension - Groq / Anthropic / OpenAI API Keys
# Clone the repository
git clone https://github.com/zenmisan/vendormind.git
cd vendormind
# Install backend & frontend dependencies
bun install
cd dashboard && bun install && cd ..Copy .env.example to .env:
cp .env.example .envConfigure credentials in .env:
PORT=3000
DATABASE_URL="postgresql://postgres:postgres@localhost:5432/vendormind?schema=public"
GROQ_API_KEY="gsk_..."
OPENAI_API_KEY="sk-..."
BMONI_API_KEY="pk_a025cacbf33a_76fb864113f3540909de5b1da39cc146906e35b1c6d4d1e4"
BMONI_BASE_URL="https://embedded-dev.bmoni.com"bunx prisma db push
bunx prisma generate# Terminal 1: Start Fastify Gateway & WhatsApp Fleet
bun run dev
# Terminal 2: Start Vite React Dashboard
cd dashboard
bun run devVisit the dashboard at http://localhost:5173.
# Verify TypeScript compilation (0 errors)
bunx tsc --noEmit
# Compile Vite production build
cd dashboard && bun run buildFor full architectural details, sequence diagrams, and deployment guides, check the docs/ directory:
- docs/README.md - Master documentation sitemap and coding standards.
- docs/architecture/bmoni-wallet-ledger.md - BMONI cNGN smart wallet ledger and payouts.
- docs/architecture/ai-sales-agent.md - Zinc AI persona and pgvector search pipeline.
- docs/architecture/whatsapp-gateway.md - Baileys multi-tenant socket fleet and reconnect guards.
- docs/architecture/catalog-embedding.md - Catalog ingestion, fuzzy CSV matcher and embedding worker.
- docs/architecture/sales-checkout-flow.md - End-to-end sales sequence and in-chat payment links.
- docs/diagrams/README.md - Mermaid C4 diagrams, sequence flows and state machines.
- docs/guides/local-development.md - Local development quickstart guide.
- docs/guides/database-setup.md - PostgreSQL + pgvector setup and Prisma schema migrations.
- docs/guides/deploy-backend.md - Fastify gateway deployment on Render / Docker.
- docs/guides/deploy-frontend.md - Vite dashboard deployment on Firebase Hosting.
Distributed under the MIT License. Built for African merchants by VendorMind Technologies.
- Live Web App: https://vendormind-z.web.app
- Support Email: zenmisan@gmail.com