🇦🇺 Sydney 🇺🇸 Arizona
Legend
Paperclip (Agent Orchestration)
n8n (Workflow Automation)
LLM Layer (Local + Cloud)
Client Interface / UX
External APIs & Services
Data & Memory
Full System Architecture
TradieMind — Multi-Tenant AI Agent Platform Paperclip + n8n + LLM Hybrid
CLIENT INTERFACES 💬 WhatsApp Primary UX AU + US 📱 SMS / iMsg Fallback (US) Twilio 🖥 Dashboard Owner Portal Your Design 🎙 Voice Note Whisper ASR In WhatsApp INGESTION LAYER ⚡ n8n Webhook Gateway Receives all incoming messages · Routes by type + client tenant self-hosted VPS · Railway · per-client namespace n8n Trigger Nodes WhatsApp Business Cloud API Twilio SMS · Webhook HTTP intent classifier node intent + payload PAPERCLIP — AGENT ORCHESTRATION 🧠 Paperclip Master Dispatcher Agent Reads intent · Selects sub-agent · Sets budget limits · Approval gate for high-stakes tasks Agent-agnostic · MIT license · Audit log all plans · Per-client cost tracking Runs Claude Sonnet / Haiku for reasoning · Local Ollama for simple tasks SUB-AGENTS (PAPERCLIP WORKERS) 📋 EstimateBot Job quoting PDF output 📸 SocialBot IG · FB posts captions+tags 📅 BookingBot Cal.com / GCal confirmations 💰 InvoiceBot Xero · Wave auto-invoice ⭐ ReviewBot Google Biz reply drafts 🥟 MenuBot Dumpling · Cater order + event ⚙ n8n Sub-Workflows (triggered by Paperclip) WhatsApp reply sender PDF generator + emailer Google Biz API poster Xero / Wave invoice push Social media scheduler Reminder + nudge crons tool calls LLM + MEMORY LAYER 🦙 Ollama Local Llama 3 · Mistral 7B routine tasks · free ☁ Claude API Sonnet / Haiku reasoning · fallback 🗃 Memory Store SQLite · Supabase per-client isolation 📂 Knowledge Base Prompt packs / RAG per vertical · tunable 🌐 External APIs (n8n orchestrates these) 📧 Meta WhatsApp Business API 📞 Twilio SMS (US fallback) 📍 Google Business Profile API 📅 Google Calendar / Cal.com 💳 Xero (AU) · Wave (US) 📸 Instagram / Facebook Graph 🎙 OpenAI Whisper ASR 📦 Square POS (US pop-ups) 🥟 Toast / Clover (Food AU/US) ✉ Resend (email delivery) 🗺 Google Maps (AU/US geo) API calls 🏗 Multi-Tenant Infra — Railway VPS (AU: Sydney region) + Railway VPS (US: Phoenix/Arizona region) Each client = isolated n8n project namespace · Separate Paperclip company · Separate memory DB · Shared LLM layer AU: Xero · ABA payments · ABN lookup | US: Wave · ACH/Stripe · EIN lookup · Arizona contractor licensing
When to Use Paperclip vs n8n
Task Use Why Example
Understand intent from a messy WhatsApp message Paperclip Agents handle ambiguity; "quote pool job tmrw arvo 3hrs" needs reasoning Master dispatcher reads + classifies message
Send the WhatsApp reply message back n8n Deterministic HTTP call to Meta API — no reasoning needed n8n HTTP node → WhatsApp Business Cloud send
Generate a job estimate with context Paperclip EstimateBot sub-agent reasons over job type, past jobs, pricing rules EstimateBot → Claude Haiku → structured JSON → n8n PDF node
Push invoice to Xero n8n Structured API call once data is ready — n8n has native Xero node n8n Xero node → create invoice → return invoice URL
Draft a Google Review reply Paperclip ReviewBot needs tone matching, context awareness, brand voice ReviewBot reads review → drafts reply → human approval gate → n8n posts
Schedule cron jobs (daily invoice reminders) n8n Pure scheduling/trigger logic, no reasoning needed n8n Schedule node → query SQLite → trigger WhatsApp nudge
Handle a dumpling pre-order via WhatsApp Paperclip MenuBot needs to handle menu Q&A, customisations, allergies, upsell MenuBot → Claude → order object → n8n pushes to Square / Clover POS
Post a job completion photo to Instagram n8n HTTP call to Graph API with caption from Paperclip Paperclip SocialBot drafts caption → n8n posts to IG via Meta Graph
MVP Verticals — Phase 1 Targets
🌿
Gardener / Tradie
AU: Sydney · US: Phoenix AZ
MVP #1
🥟
Pop-up Dumpling / Catering
AU: Sydney markets · US: AZ food trucks
MVP #2
🏊
Pool Cleaning
AU: Sydney · US: Arizona #1 mkt
🚗
Car Detailing
AU: NSW · US: Phoenix metro
✂️
Barber / Beauty
AU + US bilingual friendly
Geographic Configuration
🇦🇺
Australia (Sydney)
Railway VPS — ap-southeast-2
  • Accounting: Xero (dominant in AU)
  • Payments: Stripe AU · ABA bank transfers
  • Business reg: ABN lookup via ABR API
  • Reviews: Google Maps + True Local
  • Food compliance: NSW Food Authority hooks
  • Language: EN · Mandarin (Chinese-AU tradie market)
  • Messaging: WhatsApp primary · SMS via Twilio AU
  • Food vertical: Clover / Square AU for pop-up POS
🇺🇸
United States (Arizona)
Railway VPS — us-west-2
  • Accounting: Wave (free) · QuickBooks Self-Employed
  • Payments: Stripe US · ACH transfers · Venmo Business
  • Business reg: EIN lookup · AZ ROC contractor license check
  • Reviews: Google Maps + Yelp API
  • Food compliance: Maricopa County food permit reminders
  • Language: EN · Spanish (large Hispanic contractor market AZ)
  • Messaging: SMS primary (Twilio US) · WhatsApp secondary
  • Food vertical: Toast / Square US for pop-up + catering POS
MVP Roadmap
Phase 1 · Months 0–3
Build & Validate
Sydney (AU) + Phoenix (US)
  • 1 gardening/tradie client AU + 1 US via friend
  • 1 dumpling pop-up client in Sydney
  • EstimateBot + BookingBot + InvoiceBot only
  • n8n self-hosted on Railway · WhatsApp meta API
  • Paperclip master dispatcher + 3 sub-agents
  • Ollama local for routine · Claude API fallback
  • Mandarin + English + Spanish prompt packs
🎯 3 paying clients · $299 setup + $99/mo each
Phase 2 · Months 3–9
Productise
5+ verticals · 2 markets
  • Add SocialBot + ReviewBot + MenuBot
  • Onboarding flow in 45 min (your HCI skills)
  • Owner web dashboard (agent activity log)
  • Expand to pool cleaning, detailing, barbers
  • White-label prompt packs per vertical
  • Standardise multi-tenant Paperclip org structure
  • 10–15 clients across both markets
🎯 $149/mo per client · MRR target $1,500+
Phase 3 · Months 9–18
Scale
Franchise + network deals
  • White-label for Jim's Group (AU) / franchise chains
  • AZ contractor network deal via friend's connections
  • API-first: sell the agent layer to other developers
  • Fine-tune vertical-specific models with real job data
  • Explore "Agent as a Service" enterprise packaging
  • Food truck / pop-up marketplace integration (AU/US)
🎯 Franchise deal = 50+ clients overnight