No updates detected yet. GitHub releases will appear here.
Loading the full README. The saved excerpt is shown below.
⛽ PumpAI — AI WhatsApp CRM & forecourt management for Pakistani petrol pumps
A full-stack web app for petrol-pump owners in Pakistan. It covers:
• WhatsApp CRM: an AI agent answers customers 24/7 in Roman Urdu, Urdu or English.
• Forecourt operations: POS, shifts, tanks, dips, tanker deliveries and prices.
• Khata (credit) management.
• Background automations: loss/fraud detection, stock-out prediction, payment reminders, win-back campaigns and the owner's daily WhatsApp brief.Read the full README ↗A full-stack web app for petrol-pump owners in Pakistan. It covers:
It runs fully offline out of the box, using demo data, a built-in rule-based Roman Urdu bot and simulated WhatsApp. Add a Claude API key and WhatsApp Cloud API credentials to switch to the AI agent and live messaging.
Selling / installing for a pump owner? See INSTALL.md (one-command install with domain and HTTPS, setup wizard, updates, backups). A demo can also be put on Vercel (import the repo; see INSTALL.md → Option 3).
cd pumpai
npm install
npm run dev # API on :4000, dashboard on http://localhost:5173
Sign in (password demo1234 for all four). After one email sign-in on a tablet, staff can sign in by tapping their name and a 4-digit PIN (demo PINs: admin 1111, manager 2222, salesman 3333, wholesale 4444):
| Login | Role | Access |
|---|---|---|
[email protected] | Admin (CEO) | Everything, including Users & Roles, Settings and khata credit limits |
[email protected] | Manager | Dashboard, WhatsApp inbox, customers & khata, orders, complaints, campaigns, stock, prices, alerts, automations |
[email protected] | Salesman | POS, their own shift, customer lookup/add and prices, at their assigned station only |
[email protected] | Wholesale Officer | Only the wholesale module: clients, supplies, returns, payments, dues and statements |
First run: a demo business is created automatically: 2 stations, 5 tanks, about 8 weeks of sales, 32 customers, khata and WhatsApp chats.
Reset the demo data: npm run seed.
Production: npm run build && npm start. The API serves the built dashboard on :4000. A Dockerfile is included.
Tests: npm test runs 121 end-to-end API tests covering the WhatsApp agent, shifts, khata, stock, prices, orders, campaigns, automations, the Meta webhook, role-based access, wholesale supply (including per-client margins that follow pump price changes), expenses, suppliers, reports (including exact stock reconciliation across periods), mid-shift price changes with meter settlement, shift handover (readings, gaps, cash expenses, shift report), and a full-circle test that follows one day from the salesman's sales, expenses and meter close through a tanker delivery and a wholesale supply to the manager's notification and the admin's today book, checking every figure against the tanks and the Reports page. Further suites cover PIN sign-in and lockout, sale undo, offline sales synced once at the old price, meter/invoice/bill photos, voice-to-sale parsing (English, Roman Urdu, Urdu), khata receipts, monthly bill links, wholesale messages, QR cards, staff accounts, the cash book, tanker orders, dip charts, the midnight day close, owner questions on WhatsApp, the shop POS, vehicle limits, loyalty payments, licences, checklists, attendance and payroll cuts, owner insights (health score, staff risk, P&L, statement reconciliation, price planner, tank gain/loss), customer portal, khata hold and late charge, government bills, bookings, backups and restore, two-person price approval and push subscriptions, the stock register, coupons, wallets, ratings, the TV rate board, WhatsApp approvals, commission, monthly fixed costs and utility bills, tanker shortage claims, depot comparison, sales tax and withholding, bank statement reconciliation, the general ledger export, staff loans, salary slip PDFs, training records and daily coaching, the first-run setup wizard, branding, integrations set from the app, the audit log and the machines register.
Requires Node.js 22+ (uses the built-in node:sqlite, so there is no database server to install).
This is the beginning of the README. Read the rest at the original. Read the full README ↗