Another chatbot for WhatsApp

A complete chatbot for WhatsApp using Node.js, Typescript and following general best practices.

About   |    Technologies   |    Tools   |    Installation   |    License

🔖 About

Wpp AI is a complete chatbot for WhatsApp using Node.js, Typescript and following general best practices.

💻 Technologies

• Typescript
• Node.js
• Eslint
• Prettier
• Japa

🔧 Tools

• WebStorm

📦 Installation

✔️ Prerequisites

The following software must be installed:

• Node.js v22.13.1+
• Git
• PNPM (recommended) or NPM

⬇️ Cloning the repository

$ git clone https://github.com/gabrielmaialva33/wpp-ai.git

⚙️ Configuration

1. Copy the environment file:

$ cp .env.example .env

2. Configure your API keys in .env:

# Required Keys
WPP_SESSION=wpp_ai
BOT_NAME=AI
BOT_NAMES='["AI", "Bot", "Assistant"]'
PREFIXES='["!", "/", "$"]'

# AI Provider Keys
GEMINI_API_KEY=your-gemini-key
NVIDIA_API_KEY=your-nvidia-key

# Defaults
DEFAULT_TEXT_PROVIDER=gemini
DEFAULT_IMAGE_PROVIDER=nvidia

▶️ Running the application

$ cd wpp-ai
# Install dependencies
$ pnpm install

# Development mode
$ pnpm start:dev

# Build and run production
$ pnpm build
$ pnpm start

🤖 Available Commands

AI Commands

• !ai [provider] <question> - Chat with AI (Gemini or NVIDIA)
• !compare <question> - Compare responses from Gemini and NVIDIA
• !image <description> - Generate images with NVIDIA

Examples

!ai gemini What is artificial intelligence?
!ai nvidia Explain quantum computing
!compare What's the meaning of life?
!image a futuristic city at sunset
!image cute robot playing guitar

Supported Providers

Text Generation:

• Google Gemini (gemini-2.5-pro, gemini-2.5-flash)
• NVIDIA NIM (Llama 3.3, DeepSeek R1, Mixtral)

Image Generation:

• NVIDIA (Stable Diffusion XL)

✍️ Author

Gabriel Maia

License

MIT License