sutra-core 1.0.0

AI-powered WhatsApp ERP for India's 63 million MSMEs

SUTRA Core

AI-Powered WhatsApp ERP for India's 63 Million MSMEs
Voice. Text. Hinglish. Zero training. Runs on a ₹800/month VPS.

---

SUTRA (Systematic Unstructured Text & Resource Allocator) — a textile merchant in Surat sends a Hinglish voice note; SUTRA transcribes, checks stock, confirms the order, deducts inventory, generates a GST invoice, and sends it back via WhatsApp. No app. No login. No training.

---

✨ Features

Capability	What It Does
🎙️ Voice-to-Order	Hinglish voice notes → transcribed → structured order in <30s
📦 Auto Inventory	Stock deducted on confirmation. Restock alerts before stockout.
💰 Udhaar (Credit) Mgmt	Track credit limits, aging, auto-reminders on WhatsApp
🧾 GST Invoicing	PDF invoices generated and delivered in the same WhatsApp thread
🏢 Multi-Tenant	One deployment serves unlimited businesses with isolated data
🔐 SOC 2 Ready	AES-256 encryption, JWT auth, webhook security, RBAC
🖥️ Owner Dashboard	Analytics-only Next.js dashboard for month-end review
📡 Monitoring	Prometheus + Grafana stack. Alertmanager for critical events.

---

🚀 Quick Start

git clone https://github.com/ravikumarve/sutra-core.git
cd sutra-core && cp .env.example .env   # configure your API keys
docker compose up --build                # starts FastAPI + Redis + PostgreSQL

That's it. Your webhook listener is live at http://localhost:8000. Configure it as your Meta WhatsApp webhook URL and start receiving orders.

📖 Full deployment guide →

---

🧠 How It Works

SUTRA is an asynchronous multi-agent mesh. Three specialized agents process every message through an event-driven pipeline:

  WhatsApp ──► Webhook ──► Redis Queue ──► ┌─────────┐    ┌───────────┐
  (Voice/Text)            (Event Bus)        │ Liaison │───►│ Strategist│
                                             │ (Intent)│    │(Execution)│
                                             └─────────┘    └─────┬─────┘
                                                                  │
                                              ┌─────────┐         │
                                              │ Auditor │◄────────┘
                                              │(Ledger) │──► PDF Invoice
                                              └─────────┘    WhatsApp Reply

Agent	Role	Integrations
Liaison	Decode intent from raw text/audio	Whisper-Hinglish, Sentiment Analyzer
Strategist	Validate & execute against DB	Inventory, Credit Scoring, Pricing
Auditor	Immutable ledger + compliance	PDF Generator, GST Validator

No agent calls another directly. All communication is through AgentMessage objects on Redis Streams — enabling independent scaling, restart, and replacement.

---

🛠️ Technology Stack

Layer	Technology
Backend	FastAPI (Python 3.12+)
Database	PostgreSQL 15 with schema-level multi-tenancy
Queue	Redis Streams (per-tenant namespaced)
STT	OpenAI Whisper (CPU, Hinglish post-processing)
Dashboard	Next.js 14 + shadcn/ui (analytics-only)
Monitoring	Prometheus + Grafana + Alertmanager
CI/CD	GitHub Actions (test → lint → security scan → deploy)
Deployment	Docker Compose / systemd

---

📊 Architecture Decisions

Decision	Why
Headless (WhatsApp-first)	Shop owners are on WhatsApp 8 hours/day. No app to install. Zero adoption friction.
PostgreSQL over NoSQL	Financial ledger requires ACID. Udhaar entries must be atomic with inventory.
Redis Streams over Kafka	Single VPS deployment. Kafka is overkill. Redis handles the throughput comfortably.
CPU-only Whisper	30s async transcription latency is acceptable. No GPU = deployable anywhere.

---

📈 Roadmap

Feature	Status
Multi-agent pipeline (Liaison → Strategist → Auditor)	✅ v1.0.0
Whisper-Hinglish NLP pipeline	✅ v1.0.0
Multi-tenancy with isolated schemas	✅ v1.0.0
GST-compliant PDF invoicing	✅ v1.0.0
Docker + systemd deployment	✅ v1.0.0
CI/CD + Monitoring stack	✅ v1.0.0
Security audit (SOC 2 framework)	✅ v1.0.0
Owner analytics dashboard	🔄 In progress
Image-based order parsing (photo → SKU)	📋 Planned v1.1
UPI payment link injection	📋 Planned v1.1
Fine-tuned Whisper for 8 regional accents	📋 Planned v1.2

---

💰 Pricing Model

Plan	Price	For
Starter	₹499/month	1 WhatsApp number, 500 orders/mo
Growth	₹1,499/month	3 numbers, 2K orders/mo, 3 users
Business	₹4,999/month	Unlimited, dedicated support, custom integrations

Self-hosted is MIT licensed and free. Paid plans include managed hosting, SLA, and priority support.

---

📖 Documentation

Document	Description
Deployment Guide	Step-by-step production setup
Security Hardening	Production security measures
Monitoring Setup	Prometheus + Grafana guide
Backup Procedures	Backup & disaster recovery
Runbooks	Operational runbooks
Executive Summary	Business overview

---

🤝 Contributing

We actively welcome contributions in these high-impact areas:

• Dialect Maps — Hinglish vocabulary, regional terms, unit aliases
• Industry Presets — New business-type configs (electronics, furniture, etc.)
• Test Audio Fixtures — Real Hinglish voice note transcriptions
• Query Optimizations — PostgreSQL performance with EXPLAIN ANALYZE

See CONTRIBUTING.md for detailed guidelines.

---

📄 License

MIT — see LICENSE.

Built for the bazaar. Runs in the background. Never misses a bill.

---