• 🎯 Overview
• 🔥 Problem We Solve
• 💡 Solution
• ✨ Features
• 🛠️ Tech Stack
• 🚀 Quick Start
• 📱 Usage
• 🏗️ Architecture
• 📊 Results
• 🗺️ Roadmap
• 🤝 Contributing
• 📄 License
• 📞 Contact

TechFlow AI transforms WhatsApp into a powerful voice commerce platform, enabling 2 billion users worldwide to shop using voice messages in their native language. No typing, no app downloads - just speak and shop!

# Shop in any language with just voice
"Bhai, mujhe laptop chahiye" → 💻 Shows laptops → ✅ Order confirmed
"I need iPhone under $500" → 📱 Shows options → ✅ Order placed
"আমি জুতা কিনতে চাই" → 👟 Shows shoes → ✅ Order done

• 👵 Fatima (Karachi): "I can't type in English but want to shop online"
• 🧓 Rahman's Mother (Dhaka): "I have money but can't use shopping apps"
• 👨 Carlos (São Paulo): "My grandparents need voice shopping"

graph LR
    A[🎤 Voice Message] --> B[🤖 AI Processing]
    B --> C[✅ Order Confirmed]
    
    style A fill:#25D366
    style B fill:#0066CC
    style C fill:#00C851

1. Send Voice Note - Customer sends WhatsApp voice message in ANY language
2. AI Processes - GPT-5 understands intent, language, and context instantly
3. Order Complete - Confirmation sent, order processed, customer happy!

• ✅ 60+ languages supported
• ✅ Automatic language detection
• ✅ Mixed language understanding
• ✅ Regional dialects & accents

• 🛒 Voice-based product search
• 💰 Budget-based recommendations
• 📦 Multi-item cart management
• 🎯 Personalized suggestions
• 📊 Order tracking
• 💳 Multiple payment options

• 🧠 GPT-5 with 256K context window
• 🎤 Whisper API for transcription
• 💬 Natural conversation flow
• 🔄 Context retention across messages
• ⚡ 1.2 second response time

• 📈 Real-time analytics
• 📊 Sales tracking
• 👥 Customer insights
• 📦 Inventory management
• 💼 Order management

Python 3.12+
PostgreSQL
Twilio Account
OpenAI API Key
WhatsApp Business Account (or Sandbox)

1. Clone the repository

git clone https://github.com/yourusername/techflow-ai.git
cd techflow-ai

2. Install dependencies

pip install -r requirements.txt

3. Set up environment variables

cp .env.example .env
# Edit .env with your credentials

# .env file
OPENAI_API_KEY=your_openai_key
TWILIO_ACCOUNT_SID=......
TWILIO_AUTH_TOKEN=your_auth_token
DATABASE_URL=postgresql://user:pass@host/dbname

4. Initialize database

python database.py

5. Start the webhook server

python whatsapp_webhook.py

6. Set up ngrok tunnel

ngrok http 5000
# Copy the HTTPS URL

7. Configure Twilio webhook

Go to Twilio Console > WhatsApp Sandbox
Set webhook URL: https://your-ngrok-url.ngrok.io/webhook

8. Launch dashboard (optional)

streamlit run hackathon_dashboard.py

1. Join Sandbox (Development)

   • Send WhatsApp message to: +1 415 523 8886
   • Type: join quite-putting

2. Start Shopping

   Send: "Hello"