https://github.com/tuchanski/zapzap-lovebot
Bot powered by llama 3.3 that sends cute messages via WhatsApp [Repo in PT-BR]
https://github.com/tuchanski/zapzap-lovebot
ai bot cute cute-messages flask groq groq-api llama3 react romantic whatsapp
Last synced: 8 months ago
JSON representation
Bot powered by llama 3.3 that sends cute messages via WhatsApp [Repo in PT-BR]
- Host: GitHub
- URL: https://github.com/tuchanski/zapzap-lovebot
- Owner: tuchanski
- Created: 2025-08-05T14:30:02.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-09-04T10:30:35.000Z (10 months ago)
- Last Synced: 2025-10-05T16:39:58.788Z (8 months ago)
- Topics: ai, bot, cute, cute-messages, flask, groq, groq-api, llama3, react, romantic, whatsapp
- Language: JavaScript
- Homepage:
- Size: 316 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 💌 ZapZap LoveBot
Um bot simples, fofo e automatizado que usa inteligência artificial para gerar mensagens carinhosas e enviá-las pelo WhatsApp. Ideal para impressionar sua namorada.
---
## ✨ O que ele faz?
1. Gera uma mensagem fofa usando o modelo **LLaMA 3.3** via **Groq API**
2. Exibe a mensagem gerada na interface web com **React**
3. Permite enviar a mensagem instantaneamente via **WhatsApp Web** com **pywhatkit**
---
## 🛠️ Tecnologias usadas
**Frontend:**
- [React](https://reactjs.org/)
**Backend:**
- [Python](https://www.python.org/)
- [Flask](https://flask.palletsprojects.com/)
- [Groq API](https://www.groq.com/) (usando `llama-3.3-70b-versatile`)
- [pywhatkit](https://pypi.org/project/pywhatkit/) para automação do WhatsApp
---
## 📦 Instalação
### 1. Backend
1. Clone o repositório:
```bash
git clone https://github.com/tuchanski/zapzap-lovebot
cd zapzap-lovebot
```
2. Crie e ative um ambiente virtual:
```bash
python -m venv venv
# Windows
venv\Scripts\activate
# Linux / Mac
source venv/bin/activate
```
3. Instale as dependências:
```bash
pip install flask flask-cors pywhatkit groq
```
4. Configure a variável de ambiente `GROQ_API_KEY`:
```bash
# Windows
set GROQ_API_KEY=
# Linux / Mac
export GROQ_API_KEY=
```
Caso não tenha uma chave para a API do Groq, leia a [documentação](https://console.groq.com/docs/quickstart)
5. Rode o backend:
```bash
python app.py
```
O backend estará rodando em `http://127.0.0.1:5000`.
---
### 2. Frontend
1. Navegue até a pasta do frontend:
```bash
cd frontend
```
2. Instale as dependências:
```bash
npm install
```
3. Rode a aplicação:
```bash
npm run dev
```
O frontend estará disponível em `http://localhost:5173`.
---
## 🚀 Como usar
1. Insira o número de WhatsApp do destinatário no campo **Número do WhatsApp**
2. Escolha as tags se quiser personalizar as mensagens carinhosas do **ZapZap Lovebot**
3. Clique em **Gerar Mensagem...** para criar uma mensagem fofa com IA
4. Clique em **Enviar via WhatsApp** para enviar a mensagem diretamente
> ⚠️ O envio depende do WhatsApp Web estar logado no navegador.
---
## 📸 Exemplo de uso
---
## ⚠️ Avisos
- O `pywhatkit` abre o WhatsApp Web automaticamente no navegador.
- É necessário estar logado no WhatsApp Web para o envio funcionar.
- Use com responsabilidade e carinho.
---
## 📄 Autor
Feito com amor por [Tuchanski](https://github.com/tuchanski) 💕