🤖 AI-Powered WhatsApp Bot - Local LLM-Powered Assistant

A 💯 free, fully automated solution to interact with WhatsApp using a local LLM-powered AI assistant. This bot is designed to integrate an advanced AI model with WhatsApp for various use cases such as customer service, business automation, and personal assistance — without relying on external APIs.

---

📚 Table of Contents

1. 📌 Overview
2. ✨ Features
3. 🛠️ Installation Guide
   • Windows
   • Linux
   • macOS
4. 🚀 Usage
5. 🤝 Contributing
6. 📄 License
7. 👨‍💻 Maintainer

---

📌 Overview

This AI-Powered WhatsApp Bot uses a Local LLM (Language Learning Model) powered by Ollama to provide scalable customer engagement and automation. It's a powerful tool for businesses, startups, and marketers looking to interact with their users without any external API calls.

---

✨ Features

✅ Local LLM Integration – Uses Ollama's local AI models to ensure privacy and no external dependency.
⚙️ Fully Automated – Automated replies, conversation handling, and more.
🌍 Multi-Country Support – Global reach, works with any valid phone number format.
🔒 Free & Secure – No need for API keys, subscriptions, or internet dependency (works locally).
📈 Easy Setup – Simple setup process for both beginners and advanced users.
💬 Rich Messaging – Send rich text, media, and even custom responses through WhatsApp.

---

🛠️ Installation Guide

Prerequisites:

• Node.js and npm: Ensure that Node.js and npm (Node Package Manager) are installed on your system. You can download them from the official Node.js website (https://nodejs.org/).
• Git (Optional but Recommended): Git is recommended for version control and easier updates. Download it from (https://git-scm.com/download/).

Windows

Using Command Prompt

1. Install Node.js:

   • Download and install Node.js from Node.js official website.
   • Verify the installation:

     node -v
     npm -v

2. Clone the Repository:

   git clone https://github.com/kunaldevelopers/WhatsApp-Bot-Local-LLM-Powered-AI-Assistant.git

3. Navigate to the Project Folder:

   cd WhatsApp-Bot-Local-LLM-Powered-AI-Assistant

4. Install Dependencies:

   npm install

5. Start the Bot:

   node index.js

Using Git Bash (Recommended)

1. Install Git Bash from Git for Windows.

2. Clone the Repository:

   git clone https://github.com/kunaldevelopers/WhatsApp-Bot-Local-LLM-Powered-AI-Assistant.git

3. Follow the steps to install dependencies and start the bot, as outlined in the "Command Prompt" section.

Linux

1. Install Node.js and npm:

   • Install using NVM:

     curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
     nvm install --lts
     nvm use --lts

2. Clone the Repository:

   git clone https://github.com/kunaldevelopers/WhatsApp-Bot-Local-LLM-Powered-AI-Assistant.git

3. Navigate to the Project Folder:

   cd WhatsApp-Bot-Local-LLM-Powered-AI-Assistant

4. Install Dependencies:

   npm install

5. Start the Bot:

   node index.js

macOS

1. Install Homebrew (if not installed):

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install Node.js and npm:

   • Using Homebrew:

     brew install node

3. Clone the Repository:

   git clone https://github.com/kunaldevelopers/WhatsApp-Bot-Local-LLM-Powered-AI-Assistant.git

4. Navigate to the Project Folder:

   cd WhatsApp-Bot-Local-LLM-Powered-AI-Assistant

5. Install Dependencies:

   npm install

6. Start the Bot:

   node index.js

---

🚀 Usage

1. Prepare your contacts in a .txt file or other supported formats with valid phone numbers.
2. Start the bot:

   node index.js

3. Input your message to be sent to your contacts.
4. Monitor the logs for status updates and possible errors.

---

🤝 Contributing

Want to enhance this bot or add features? Here's how you can contribute:

1. Fork the repository 🍴
2. Create a new branch (git checkout -b feature/your-feature-name)
3. Commit your changes ✅
4. Push and create a pull request 🚀

If you find bugs or have ideas, open an issue — we’d love to hear from you!

---

👨‍💻 Project Maintainer & Creator

Kunal Kumar Pandit

• 💼 LinkedIn
• 📷 Instagram
• 📧 Gmail
• 🌐 Website
• 💻 GitHub

---

📄 License

This project is open-source and available under the MIT License.

---

🙌 If this project helped you, please star ⭐ the repository and share it with your network!