🎵 MikuBot — WhatsApp AI Bot

A Hatsune Miku-themed WhatsApp AI chatbot — powered by Groq, Baileys, and Supabase Edge Functions.

---

✨ Features

• 🤖 AI Chat — Powered by Groq (Llama 4 Scout by default)
• 🎤 Voice-to-Text — Transcribes voice messages via Groq Whisper
• 🧠 Chat History — Per-user conversation memory via Supabase
• 🚫 Rate Limiting & Blocking — Managed through Edge Functions
• 🌐 Web Dashboard — Manage settings via browser
• 🔗 Pairing Code Auth — No QR scan needed, just a phone number

---

🛠️ Tech Stack

Component	Technology
WhatsApp	@whiskeysockets/baileys
Web Server	express
AI Backend	Groq API
Database	Supabase Edge Functions
STT	Groq Whisper

---

🚀 Setup

1. Clone the repo

git clone https://github.com/M5Develop/MikuBot-WhatsApp.git
cd MikuBot-WhatsApp

2. Install dependencies

npm install

3. Configure environment

cp .env.example .env

Fill in your keys in .env.

4. Run

npm start

Dashboard available at http://localhost:3000

---

🔑 Environment Variables

Variable	Required	Description
GROQ_API_KEY	✅	Groq API key — free at console.groq.com
SUPABASE_URL	✅	Your Supabase project URL

---

📱 Connecting to WhatsApp

1. Open the dashboard at http://localhost:3000
2. Enter your WhatsApp phone number
3. Get the pairing code and enter it in WhatsApp → Linked Devices

---

🗂️ Project Structure

MikuBot-WhatsApp/
├── index.js      # Entry point — DB → Bot → Server boot sequence
├── bot.js        # Baileys socket, message handler, STT
├── ai.js         # Groq chat + Whisper transcription
├── db.js         # Supabase Edge Functions client
├── routes.js     # Express dashboard API routes
├── .env.example
└── package.json

---

📄 License

MIT — free to use, modify, and build on.

---

Made with 💙 by M5Develop | HuggingFace