https://github.com/usualdork/aiwhisper
An intelligent WhatsApp bot that leverages Google's Gemini AI to provide automated, context-aware responses through a modern web dashboard.
https://github.com/usualdork/aiwhisper
automation chatbot gemini-ai gemini-ai-chatbot nodejs-ai-assistant whatsapp-bot whatsapp-bot-baileys-nodejs
Last synced: about 2 months ago
JSON representation
An intelligent WhatsApp bot that leverages Google's Gemini AI to provide automated, context-aware responses through a modern web dashboard.
- Host: GitHub
- URL: https://github.com/usualdork/aiwhisper
- Owner: usualdork
- License: mit
- Created: 2025-07-15T14:30:51.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-15T15:09:53.000Z (12 months ago)
- Last Synced: 2025-07-16T08:33:22.342Z (12 months ago)
- Topics: automation, chatbot, gemini-ai, gemini-ai-chatbot, nodejs-ai-assistant, whatsapp-bot, whatsapp-bot-baileys-nodejs
- Language: TypeScript
- Homepage:
- Size: 859 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AIWhisper: The World's First Revolutionary AI-Powered WhatsApp Automation Suite
**AIWhisper** is the groundbreaking, cutting-edge AI-driven WhatsApp bot platform that redefines messaging automation. As the world's first intelligent, autonomous conversational AI for WhatsApp, AIWhisper leverages state-of-the-art generative AI (powered by Gemini) and seamless integration with Baileys to deliver hyper-personalized, context-aware responses at scale. Built with Next.js and integrated with Google's Gemini AI, it enables businesses and developers to create intelligent WhatsApp bots that can handle customer inquiries, provide support, and automate messaging workflows.
## Why AIWhisper? The Unique Edge
- **World's First AI-Native WhatsApp Orchestrator**: Unlike traditional bots, AIWhisper's symbiotic fusion of Next.js frontend, Genkit AI backend, and real-time WhatsApp connectivity creates an unprecedented ecosystem for smart messaging.
- **Intelligent Responses**: Context-aware replies using Gemini AI
- **Easy Setup**: QR code authentication with WhatsApp Web
- **Scalable Architecture**: Built on modern web technologies
- **Real-time Analytics**: Track conversations and bot performance
- **Multi-agent Support**: Deploy multiple AI agents with different personalities
## Features
### Core Functionality
- ✅ **AI-Powered Responses** - Gemini AI integration for natural conversations
- ✅ **WhatsApp Integration** - Seamless connection via Baileys library
- ✅ **Agent Management** - Create and configure multiple AI personalities
- ✅ **Knowledge Base** - Upload documents for context-specific responses
- ✅ **QR Code Authentication** - Secure WhatsApp Web login
### Dashboard & Analytics
- ✅ **Real-time Monitoring** - Live message tracking and statistics
- ✅ **Response Analytics** - Performance metrics with Recharts visualizations
- ✅ **Message History** - Complete conversation logs
- ✅ **User Management** - Role-based access control
### Technical Features
- ✅ **Multi-modal Support** - Text, images, and document processing
- ✅ **Responsive Design** - Built with Radix UI components
- ✅ **API-First Architecture** - RESTful API for integrations
- ✅ **Environment Configuration** - Easy deployment and configuration
## Quick Start
### Prerequisites
- Node.js 18+
- npm or yarn package manager
- Google Gemini API key
### Installation
1. Clone the repository:
```bash
git clone https://github.com/usualdork/AIWhisper.git
cd AiWhisper
```
2. Install dependencies:
```bash
npm install
```
3. Set up environment:
```bash
- Copy `.env.example` to `.env`
- Add your `GEMINI_API_KEY`
```
4. Run development server:
```bash
npm run dev
```
And for AI backend:
```bash
npm run genkit:dev
```
## Usage
1. Access the dashboard at `http://localhost:9002`.
2. Scan the QR code to connect your WhatsApp account.
3. Configure agents in the Agent Designer.
4. Start receiving and auto-responding to messages!
## Architecture
### Technology Stack
- **Frontend**: Next.js 15, Radix UI, TailwindCSS
- **Backend**: Node.js, Genkit AI framework
- **AI**: Google Gemini Pro/Flash models
- **WhatsApp**: Baileys WebSocket library
- **Storage**: File-based session management
- **Analytics**: Recharts for data visualization
## Roadmap
- [ ] Voice message transcription and response
- [ ] Multi-language support beyond English
- [ ] Team collaboration features
- [ ] Webhook integrations
- [ ] Advanced analytics dashboard
- [ ] Mobile app for management
## Credits
- [Baileys](https://github.com/whiskeysockets/baileys) - WhatsApp Web API
- [Google Gemini](https://ai.google.dev/) - AI language models
- [Next.js](https://nextjs.org/) - React framework
## Contributing
We welcome contributions! Fork the repo, create a feature branch, and submit a pull request. Let's build the future of AI messaging together.
## License
MIT License – Free to use, modify, and distribute.
Star this repo if AIWhisper revolutionizes your workflow! 🚀