An Opensource WhatsApp bot by d-gibr1l & Team Hooper — built with Baileys Multi-Device for maximum features, stability and compatibility.
| Feature | Details |
|---|---|
| 🌐 Web Dashboard | Configure the bot in real-time through a beautiful web dashboard UI. |
| 🤖 Triple AI | ChatGPT · Claude · Gemini — with multi-key pool for rate-limit distribution |
| 💬 Chatbot | Group chatbot (replies to @mentions) + DM chatbot (toggleable) |
| 📥 Universal Downloader | TikTok · Instagram · Pinterest · Facebook · Twitter/X · Threads · Videy · Mega · SoundCloud · Spotify · YouTube · Sfile · MediaFire |
| 🎬 Movie Search | Integrated TMDB plugin to search and find movies & TV shows directly in chat. |
| 🎨 20 Bot Characters | Switch personality: Hooper, Power, Makima, Zero Two, Miku, Rem & 14 more |
| 🛡️ Full Moderation | Silent ban (user & group), role hierarchy, bot mode (Self/Private/Public), and Advanced Anti-Delete System. |
| 👥 Group Management | Promote, demote, tagall, antilink, welcome/goodbye, info, link & more |
| 🔖 Sticker Toolkit | Make stickers from image/video, meme stickers, quote stickers, emoji mixer |
| 🔄 Media Converters | Sticker↔Image/GIF/MP4, Video→MP3, Image→PDF, Media→URL, URL→QR |
| 🔍 Search Engine | Google, Wikipedia, YouTube, Lyrics, Weather, GitHub, Wallpapers, Ringtones |
| 🧩 Live Plugin Store | Install/uninstall plugins from URL — no restart needed |
| ☁️ MongoDB Powered | All settings persist: bans, mods, modes, chatbot, welcome, characters |
| 🔧 FFmpeg Bundled | No manual FFmpeg install needed — shipped via ffmpeg-static |
| 🆔 Baileys v7 Ready | Full LID resolution — owner detection & chatbot @mentions work correctly |
Set these in
.env(local) or as Environment Variables on your hosting platform.
Multiple API keys can be comma-separated — the bot picks one randomly per request.
| Variable | Description | Required |
| MONGODB | Your MongoDB connection URL | 🟢 |
| GROQ_API | Groq API key for Llama 3.1 AI integration | Optional |
| PACKNAME | Sticker pack name (default: Hooper Bot) | Optional |
| AUTHOR | Sticker author name (default: by: Team Hooper) | Optional |
| PORT | Server port (default: 10000) | Optional |
| GC_INTERVAL_MINUTES | MongoDB garbage collection interval in minutes (default: 5) | Optional |
| WATCHDOG_INTERVAL_SECONDS | WhatsApp server health-probe interval in seconds (default: 60) | Optional |
| MESSAGE_CACHE_TTL_MINUTES | Anti-delete message retention in minutes (default: 360, minimum: 30) | Optional |
| MESSAGE_CACHE_MAX_PER_CHAT | Maximum anti-delete messages retained per chat (default: 500, minimum: 50) | Optional |
Requirements: Node.js · Git · libwebp (Linux only)
FFmpeg is bundled automatically via
ffmpeg-static— no manual install needed!
# 1. Clone and enter the directory
git clone https://github.com/d-gibr1l/WhatsApp-Bot
cd WhatsApp-Bot
# 2. Install dependencies
npm install
# 3. Copy and fill in your config
cp .env.example .env
# → Edit .env with your values
# 4. Start the bot using PM2
npm install -g pm2
pm2 start ecosystem.config.cjsScan the QR that appears in your browser via WhatsApp → Linked Devices → Link a device.
Lost your session? Change
SESSION_IDto any new random value in.envand restart.
sudo apt update && sudo apt upgrade -y
sudo apt install -y bash git nodejs npm ffmpeg libwebp-dev imagemagick wget curl
git clone https://github.com/d-gibr1l/WhatsApp-Bot
cd WhatsApp-Bot
npm install
npm install -g pm2
cp .env.example .env
# → Edit .env with your values
pm2 start ecosystem.config.cjsStop bot: pm2 kill | Restart: pm2 restart Hooper | Update session: edit SESSION_ID in .env, then git pull && pm2 restart Hooper
Hooper MD comes packed with a robust set of features to power your groups and DMs. Instead of a massive list of commands, here are the top capabilities you get out-of-the-box:
- 🤖 Advanced AI Integrations: Seamlessly chat with the blazing fast Groq AI (Llama 3.1). Built-in prompt management and conversational memory keep your AI interactions contextual and lightning fast.
- 🛠️ Group Moderation & Management: Take full control of your groups. Features include silent bans (users are ignored by the bot), anti-link protection, customizable welcome/goodbye messages, tagging all members, and managing admin roles fluidly.
- 📥 Universal Downloader: Simply send a link from TikTok, Instagram, YouTube, X (Twitter), Pinterest, Spotify, Facebook, or SoundCloud, and the bot will instantly recognize and download the media or audio for you.
- 🖼️ Media & Sticker Toolkit: Create static, animated, or meme stickers directly from images and videos. Convert media between formats (MP4 to MP3, Image to PDF, Sticker to Video) with ease. Includes built-in Google Emoji Kitchen mixing!
- 🧩 Live Plugin Architecture: Expand the bot's functionality without ever shutting it down. Use
-installto add new commands directly from GitHub gists or URLs on the fly. - 🔍 Search & Utilities: Built-in Google searches, YouTube scraping, lyrics fetcher, HD wallpapers, Pinterest images, GitHub profiling, and real-time weather information.
- 🌸 Anime Characters: Pick from 20 different anime bot personalities (like Power, Makima, Zero Two) to act as your assistant.
Tip: You can view the full list of available commands anytime by typing
-helpin your chat!
We've recently overhauled Hooper MD to be faster, lighter, and more reliable:
- MongoDB Caching Layer: Message and contact caches have been completely migrated from RAM to MongoDB. This drastically reduces the bot's memory footprint and allows for persistent cache storage with automatic TTL cleanup.
- Upgraded Anti-Delete: The Anti-Delete listener now pulls historic deleted messages and media seamlessly from MongoDB, automatically reconstructing BSON Binary buffers for reliable alert forwarding.
- Supercharged Pinterest Search: The
.pincommand now queries Pinterest's native JSON API using in-memory cached guest cookies, entirely bypassing slow web scraping for instant image results. .statusCommand: Added a robust command to instantly retrieve and forward any contact's recent statuses directly from the database cache.- Zero-Latency
.help: The interactive help menu video is now permanently cached in RAM on startup, resulting in instant replies. - Docker & CI Upgrades: Added
--legacy-peer-depsto GitHub Actions and Dockerfile to permanently resolvejimp/baileysinstallation conflicts.
- Deprecated buggy commands and bloated search plugins that were causing memory leaks and boot loops (cleaned up obsolete logic in
search.jsandgroup.js). - Stripped away legacy RAM storage
store.messagesarrays that were blowing up server memory instances, migrating all storage cleanly to MongoDB.
Switch the bot's personality and profile picture with -setchar <ID>. Use -charlist to see all.
| ID | Character | Series | ID | Character | Series |
|---|---|---|---|---|---|
| 0 | Hooper MD | Default | 10 | Mizuhara | Rent-A-Girlfriend |
| 1 | Power | Chainsaw Man | 11 | Rem | Re:Zero |
| 2 | Makima | Chainsaw Man | 12 | Sumi | Rent-A-Girlfriend |
| 3 | Denji | Chainsaw Man | 13 | Kaguya | Kaguya-sama |
| 4 | Zero Two | Darling in the FranXX | 14 | Yumeko | Kakegurui |
| 5 | Chika | Kaguya-sama | 15 | Kurumi | Date A Live |
| 6 | Miku | Vocaloid | 16 | Mai | Bunny Girl Senpai |
| 7 | Marin | My Dress-Up Darling | 17 | Yor | Spy x Family |
| 8 | Ayanokoji | Classroom of the Elite | 18 | Shinbou | Various |
| 9 | Ruka | Rent-A-Girlfriend | 19 | Eiko | Various |
| Package | Purpose |
|---|---|
| WhiskeySockets Baileys v7 | WhatsApp Multi-Device engine |
| MongoDB | Database for all persistent settings |
| ffmpeg-static | Bundled FFmpeg — no manual install |
| wa-sticker-formatter | Sticker creation and conversion |
- 100% Open Source — MIT license, fork and modify freely.
- 300+ Commands across all plugins, plus a live plugin store for extending without restart.
- Lightning Fast Groq AI (Llama 3.1) built-in with conversation memory.
- Universal 13-Platform Downloader — one command, any link.
- Silent Banning — banned users and groups receive zero response; bot acts as if it doesn't exist.
- No local session storage — session is stored in MongoDB for privacy and security.
- Platform-agnostic — works on Railway, Heroku, Koyeb, Render, Docker, pm2, and local.
- FFmpeg bundled — reactions and sticker conversions work out of the box, everywhere.
- This bot is not made by WhatsApp Inc. — overuse may result in account ban.
- Support is provided only for deployment/setup, not for custom development.
- Made for Educational / Fun / Group Management purposes only. Team Hooper is not responsible for misuse.
- Use your own MongoDB URL for privacy and security.
- Heavy modifications are at your own risk — we cannot support every custom fork.
- We are not responsible for harm caused by individuals running this bot in groups.