An open API service indexing awesome lists of open source software.

https://github.com/gabrielmaialva33/wpp-ai

WppAI ✨ is a chatbot with some useful functions.
https://github.com/gabrielmaialva33/wpp-ai

gpt gpt-3 gpt-4 knex objectionjs openai whatsapp whatsapp-bot wpp wppconnect

Last synced: 2 months ago
JSON representation

WppAI ✨ is a chatbot with some useful functions.

Awesome Lists containing this project

README

          




AI


Another chatbot for WhatsApp



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


License
GitHub top language
GitHub language count
Repository size

GitHub last commit
Maia



About   |   
Technologies   |   
Tools   |   
Installation   |   
License


## :bookmark: About

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


## :computer: Technologies

- **[Typescript](https://www.typescriptlang.org/)**
- **[Node.js](https://nodejs.org/)**
- **[Eslint](https://eslint.org/)**
- **[Prettier](https://prettier.io/)**
- **[Japa](https://japa.dev/)**


## :wrench: Tools

- **[WebStorm](https://www.jetbrains.com/webstorm/)**


## :package: Installation

### :heavy_check_mark: **Prerequisites**

The following software must be installed:

- **[Node.js v22.13.1+](https://nodejs.org/en/)**
- **[Git](https://git-scm.com/)**
- **[PNPM](https://pnpm.io/)** (recommended) or **[NPM](https://www.npmjs.com/)**


### :arrow_down: **Cloning the repository**

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


### :gear: **Configuration**

1. Copy the environment file:
```sh
$ cp .env.example .env
```

2. Configure your API keys in `.env`:
```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
```


### :arrow_forward: **Running the application**

```sh
$ cd wpp-ai
# Install dependencies
$ pnpm install

# Development mode
$ pnpm start:dev

# Build and run production
$ pnpm build
$ pnpm start
```


## :robot: **Available Commands**

### AI Commands
- `!ai [provider] ` - Chat with AI (Gemini or NVIDIA)
- `!compare ` - Compare responses from Gemini and NVIDIA
- `!image ` - 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)


### :writing_hand: **Author**

| [![Gabriel Maia](https://avatars.githubusercontent.com/u/26732067?size=100)](https://github.com/gabrielmaialva33) |
| ----------------------------------------------------------------------------------------------------------------- |
| [Gabriel Maia](https://github.com/gabrielmaialva33) |

## License

[MIT License](./LICENSE)