██████╗  █████╗ ███╗   ██╗██╗  ██╗██╗███████╗██╗   ██╗
██╔══██╗██╔══██╗████╗  ██║██║ ██╔╝██║██╔════╝╚██╗ ██╔╝
██████╔╝███████║██╔██╗ ██║█████╔╝ ██║█████╗   ╚████╔╝ 
██╔══██╗██╔══██║██║╚██╗██║██╔═██╗ ██║██╔══╝    ╚██╔╝  
██║  ██║██║  ██║██║ ╚████║██║  ██╗██║██║        ██║   
╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝╚═╝        ╚═╝   
                                                        
 █████╗ ███████╗███████╗██╗███████╗████████╗          
██╔══██╗██╔════╝██╔════╝██║██╔════╝╚══██╔══╝          
███████║███████╗███████╗██║███████╗   ██║             
██╔══██║╚════██║╚════██║██║╚════██║   ██║             
██║  ██║███████║███████║██║███████║   ██║             
╚═╝  ╚═╝╚══════╝╚══════╝╚═╝╚══════╝   ╚═╝             

🎯 Your Voice. Your Browser. Your Smart Home. One Command.

---

Transform your voice into browser automation and smart home control
Built with safety-first architecture • Powered by Tuya AI • 100% Open Source

🚀 Quick Start • 📖 Documentation • 🏗️ Architecture • 🎬 Demo

---

🌟 What Makes It Special

🌐 Browser Magic Voice → Action "Check my Gmail" ↓ 🔒 Safety Check ↓ ✅ You Approve ↓ 🌐 Browser Opens ↓ 📊 "5 Unread Emails" 100% Safe! Never executes without permission

🏠 Smart Home Voice → Instant "Turn on lights" ↓ ⚡ Instant Execution ↓ 💡 Lights On ↓ ✅ "Done!" Lightning Fast! No confirmation needed

💬 AI Chat Voice → Answer "What's 2+2?" ↓ 🧠 AI Thinks ↓ 💭 "It's 4" ↓ 🔊 Voice Response Contextual! Remembers conversation

---

✨ Features That WOW

Feature	Description	Status
🎤	Voice Control - Natural language commands via SmartLife app	✅
🔒	Safety First - Explicit confirmation for ALL browser actions	✅
🌐	Browser Automation - Gmail, YouTube, Google Search, any site!	✅
💡	Smart Home - Control lights, AC, locks, any Tuya device	✅
🧠	Conversational AI - Chat with memory and context	✅
👥	Multi-User - Google OAuth authentication	✅
☁️	Cloud Native - Always-on Vercel + Supabase	✅
💰	100% FREE - Zero cost deployment	✅
🔓	Open Source - MIT License, all code included	✅

---

🎬 See It In Action

🌐 Browser Automation Flow

graph LR
    A[👤 You<br/>"Check Gmail"] --> B[🧠 AI Plans<br/>Browser Task]
    B --> C[🔊 AI Asks<br/>"Proceed?"]
    C -->|You: "Yes"| D[🌐 Browser Opens]
    C -->|You: "No"| E[❌ Cancelled]
    D --> F[📊 Result<br/>"5 Unread"]
    F --> G[🔊 AI Speaks<br/>Result]
    
    style A fill:#e1f5ff,stroke:#01579b,stroke-width:3px
    style C fill:#fff3e0,stroke:#e65100,stroke-width:3px
    style D fill:#e8f5e9,stroke:#2e7d32,stroke-width:3px
    style E fill:#ffebee,stroke:#c62828,stroke-width:3px
    style G fill:#f3e5f5,stroke:#4a148c,stroke-width:3px

Loading

🏠 Smart Home Flow

graph LR
    A[👤 You<br/>"Turn on lights"] --> B[🧠 AI<br/>Recognizes]
    B --> C[⚡ Instant<br/>Execution]
    C --> D[💡 Lights<br/>Turn On]
    D --> E[🔊 AI Confirms<br/>"Done!"]
    
    style A fill:#e1f5ff,stroke:#01579b,stroke-width:3px
    style C fill:#fff3e0,stroke:#ff6f00,stroke-width:3px
    style D fill:#e8f5e9,stroke:#2e7d32,stroke-width:3px
    style E fill:#f3e5f5,stroke:#4a148c,stroke-width:3px

Loading

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────┐
│                  🎤 SMARTLIFE APP                       │
│              "Your Voice Commands Here"                 │
└────────────────────┬────────────────────────────────────┘
                     │
                     ↓
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃          ☁️  TUYA AI WORKFLOW (Cloud)                  ┃
┃  ┌──────────────┬──────────────┬──────────────┐        ┃
┃  │ 🧠 Intent    │ 🌐 Browser   │ 🏠 IoT       │        ┃
┃  │ Recognition  │ Planner      │ Controller   │        ┃
┃  └──────────────┴──────────────┴──────────────┘        ┃
┗━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┛
                     │           │
        ┌────────────┴───┐   ┌───┴────────────┐
        ↓                ↓   ↓                ↓
┌────────────────┐ ┌────────────────┐ ┌────────────────┐
│ 🐍 Browser MCP │ │ 🐍 Device MCP  │ │ 💬 Chat        │
│ (Your PC)      │ │ (Your PC)      │ │ Direct Response│
└───────┬────────┘ └────────┬───────┘ └────────────────┘
        │                   │
        ↓                   ↓
┌────────────────┐ ┌────────────────┐
│ 🚀 Vercel      │ │ 🔌 Tuya API    │
│ Cloud Bridge   │ │ Smart Devices  │
└───────┬────────┘ └────────────────┘
        │
        ↓
┌────────────────┐
│ 🧩 Chrome Ext  │
│ Your Browser   │
└────────────────┘

🎯 Design Philosophy: Local MCP Servers + Cloud Bridge = Zero Cost + Maximum Control

---

🚀 Quick Start (30 Minutes)

🎯 4 Simple Steps to Voice-Controlled Everything

1️⃣ ☁️ Cloud Deploy Supabase ↓ Deploy Vercel ↓ Set Env Vars ⏱️ 10 mins

2️⃣ 🧩 Extension pnpm install ↓ pnpm build ↓ Load in Chrome ⏱️ 5 mins

3️⃣ 🐍 MCPs Install SDK ↓ Configure .env ↓ Run Servers ⏱️ 10 mins

4️⃣ 🎤 Test Say Command ↓ Confirm ↓ Watch Magic! ⏱️ 5 mins

📖 Detailed Guide →

---

💎 Technology Stack

Powered by Best-in-Class Technologies

AI Engine

MCP Servers

Cloud API

Database

Extension

LLM Engine

Authentication

UI Framework

MCP Protocol

---

💰 Pricing (Spoiler: It's FREE!)

Service	Free Tier	Your Usage	Monthly Cost
🗄️ Supabase	500MB DB, ∞ Requests	~10MB	$0
🚀 Vercel	100k Serverless Calls	~1k	$0
🔌 Tuya IoT	1000 API Calls/Day	~50/day	$0
🐍 MCP Servers	Offline & Online	~ no limit	$0
🧩 Extension	Chrome Only	Browser	$0
💎 TOTAL			$0/month

🎉 Yes, Forever FREE!

---

🧪 Try These Commands

🌐 Browser Commands	🏠 Smart Home	💬 Chat
✅ "Check my Gmail" ✅ "Open YouTube" ✅ "Search for AI news" ✅ "Go to Twitter" ✅ "Find pizza near me"	✅ "Turn on lights" ✅ "Set AC to 22°" ✅ "Lock front door" ✅ "Dim bedroom lights" ✅ "Turn off all devices" Instant execution! ⚡	✅ "What's 2+2?" ✅ "Tell me a joke" ✅ "What's the weather?" ✅ "Explain quantum physics" ✅ "Help me plan dinner" Natural conversation! 💭

---

📊 Project Stats

---

📂 Repository Structure

┌─ RankifyAssist
│
├─📁 cloud-bridge/          🚀 Vercel serverless API
│  ├─ api/                  ├─ /execute, /poll, /result, /auth
│  ├─ lib/                  ├─ Supabase client, auth helpers
│  ├─ public/               └─ Admin UI (config management)
│  └─ supabase-schema.sql   📝 Database schema
│
├─📁 mcp-servers/           🐍 Python MCP servers (local files & HuggingFace online)
│  ├─ browser-automation/   ├─ WebSocket to Tuya Gateway
│  └─ device-controller/    └─ Calls Tuya OpenAPI
│
├─📁 extension-raw/         🧩 Chrome extension source
│  ├─ chrome-extension/     ├─ Background scripts
│  └─ pages/                └─ Options UI, Side panel
│
├─📁 firmware/              💻 T5 AI Core firmware (optional if u want own modification)
│  ├─ src/                  ├─ Voice input, TTS output
│  └─ include/              └─ Device configuration
│
└─📁 docs/                  📖 Complete documentation
   ├─ deployment/           ├─ Quick start guides
   ├─ cloud-bridge/         ├─ Infrastructure docs
   ├─ mcp/                  ├─ MCP setup
   ├─ extension/            ├─ Build guides
   └─ workflow/             └─ Tuya AI configuration

---

🎓 Learning Resources

📚 Topic	🔗 Link	⏱️ Time
Quick Start	Deploy in 30 mins	30m
Architecture	System Design	15m
MCP Setup	Configure MCPs	20m
Extension	Build Guide	10m
Workflow	Tuya Configuration	25m
Checklist	Pre-commit	5m

---

🛡️ Security & Privacy

🔒 Safety-First Design

Feature	Implementation	Status
🔐 Single ID Access	A single MCP Access ID connects whole mcp->server->database->extension	✅
🔑 OAuth Authentication	Google OAuth 2.0 for secure login	✅
🗄️ Encrypted Storage	Supabase RLS policies + encrypted credentials	✅
🚫 No Data Collection	Zero telemetry, zero tracking	✅
🔓 Open Source	Full code transparency	✅

---

🤝 Contributing

We ❤️ Contributions!

graph LR
    A[🍴 Fork Repo] --> B[🌿 Create Branch]
    B --> C[✏️ Make Changes]
    C --> D[✅ Test Locally]
    D --> E[📝 Commit]
    E --> F[🚀 Push]
    F --> G[📬 Pull Request]
    G --> H[🎉 Merged!]
    
    style A fill:#e3f2fd
    style H fill:#c8e6c9

Loading

---

📜 License

Free to use, modify, and distribute

View License

---

🙏 Credits & Thanks

AI Workflow Engine

Cloud Infrastructure

Serverless Platform

Firmware Framework

---

🚀 Ready to Start?

Transform Your Voice Into Action Today!

📖 Quick Start Guide • 🏗️ Architecture • 📚 Full Docs

---

_{Built with ❤️ by the Rankify Assist Team}

_{⭐ Star this repo if you find it useful! ⭐}

---