WhatsApp Assistant Bot
A lean, personal WhatsApp assistant built with Baileys, PostgreSQL, and Drizzle ORM. Designed for private use to manage reminders, tasks, and utilities directly through WhatsApp DMs.Quickstart
Get up and running in minutes by scanning a QR code and sending your first command
Installation
Complete installation guide with prerequisites, dependencies, and build steps
What is this bot?
The WhatsApp Assistant Bot transforms your WhatsApp into a powerful personal productivity tool. By leveraging the Baileys library, this bot connects to WhatsApp Web and responds to your commands in real-time. This bot is designed exclusively for direct messages (DMs). It explicitly ignores group messages to ensure privacy and maintain focus on your personal tasks.Key features
Personal reminders
Set time-based notifications with natural language like
!notify call mom 30mTask management
Maintain a persistent todo list with add, list, complete, and delete operations
Notes
Save and search through text snippets for quick reference
Sticker maker
Convert images, GIFs, and videos to WhatsApp stickers instantly
Timers
Set countdown timers for quick alerts
Spotify control
Link your Spotify account to control playback from WhatsApp
Instagram downloader
Automatically download Instagram reels and posts by sending the URL
Tech stack
Built with modern technologies for reliability and performance:- Runtime: Node.js (ESM modules)
- WhatsApp: Baileys (WhiskeySockets)
- Database: PostgreSQL for data persistence
- ORM: Drizzle ORM for type-safe database operations
- Image Processing: Sharp for sticker creation
- Scheduling: node-cron for reminder notifications
- Server: Express for health checks and OAuth callbacks
Available commands
Here’s a quick overview of what you can do:| Command | Usage | Description |
|---|---|---|
!notify | !notify <task> <time> | Set a reminder (e.g., !notify call mom 30m) |
!todo | !todo <add/list/done/delete/clear> | Manage your persistent todo list |
!note | !note <save/list/view/delete/search> | Manage your personal snippets |
!sticker | !sticker [f/full] | Convert media to sticker (reply or caption) |
!timer | !timer <start/list/cancel> | Set countdown timers |
!help | !help [command] | Show usage instructions |
Security and privacy
- Authentication data is stored locally in the
auth_info/folder - Never share the
auth_info/folder as it contains your WhatsApp session credentials - All data is stored in your PostgreSQL database with secure connections
- The bot only responds to messages from your own WhatsApp number
Next steps
Get started with quickstart
Follow our quickstart guide to scan the QR code and send your first command
Full installation guide
Learn about prerequisites, environment setup, and production deployment