{"id":31632692,"url":"https://github.com/tuchanski/zapzap-lovebot","last_synced_at":"2025-10-16T15:53:46.572Z","repository":{"id":308402114,"uuid":"1032593644","full_name":"tuchanski/zapzap-lovebot","owner":"tuchanski","description":"Bot powered by llama 3.3 that sends cute messages via WhatsApp [Repo in PT-BR]","archived":false,"fork":false,"pushed_at":"2025-09-04T10:30:35.000Z","size":324,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-05T16:39:58.788Z","etag":null,"topics":["ai","bot","cute","cute-messages","flask","groq","groq-api","llama3","react","romantic","whatsapp"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tuchanski.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-05T14:30:02.000Z","updated_at":"2025-09-04T19:43:32.000Z","dependencies_parsed_at":"2025-08-05T19:31:59.049Z","dependency_job_id":"f3d23627-6aeb-4f7f-8863-7e7c2e462bb2","html_url":"https://github.com/tuchanski/zapzap-lovebot","commit_stats":null,"previous_names":["tuchanski/whatsapp-lovebot","tuchanski/zapzap-lovebot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tuchanski/zapzap-lovebot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuchanski%2Fzapzap-lovebot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuchanski%2Fzapzap-lovebot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuchanski%2Fzapzap-lovebot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuchanski%2Fzapzap-lovebot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tuchanski","download_url":"https://codeload.github.com/tuchanski/zapzap-lovebot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuchanski%2Fzapzap-lovebot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278692948,"owners_count":26029408,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","bot","cute","cute-messages","flask","groq","groq-api","llama3","react","romantic","whatsapp"],"created_at":"2025-10-06T23:03:25.347Z","updated_at":"2025-10-06T23:05:14.027Z","avatar_url":"https://github.com/tuchanski.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💌 ZapZap LoveBot\n\nUm bot simples, fofo e automatizado que usa inteligência artificial para gerar mensagens carinhosas e enviá-las pelo WhatsApp. Ideal para impressionar sua namorada.\n\n---\n\n## ✨ O que ele faz?\n\n1. Gera uma mensagem fofa usando o modelo **LLaMA 3.3** via **Groq API**\n2. Exibe a mensagem gerada na interface web com **React**\n3. Permite enviar a mensagem instantaneamente via **WhatsApp Web** com **pywhatkit**\n\n---\n\n## 🛠️ Tecnologias usadas\n\n**Frontend:**\n\n-   [React](https://reactjs.org/)\n\n**Backend:**\n\n-   [Python](https://www.python.org/)\n-   [Flask](https://flask.palletsprojects.com/)\n-   [Groq API](https://www.groq.com/) (usando `llama-3.3-70b-versatile`)\n-   [pywhatkit](https://pypi.org/project/pywhatkit/) para automação do WhatsApp\n\n---\n\n## 📦 Instalação\n\n### 1. Backend\n\n1. Clone o repositório:\n\n```bash\ngit clone https://github.com/tuchanski/zapzap-lovebot\ncd zapzap-lovebot\n```\n\n2. Crie e ative um ambiente virtual:\n\n```bash\npython -m venv venv\n# Windows\nvenv\\Scripts\\activate\n# Linux / Mac\nsource venv/bin/activate\n```\n\n3. Instale as dependências:\n\n```bash\npip install flask flask-cors pywhatkit groq\n```\n\n4. Configure a variável de ambiente `GROQ_API_KEY`:\n```bash\n# Windows\nset GROQ_API_KEY=\u003csua_api_key\u003e\n# Linux / Mac\nexport GROQ_API_KEY=\u003csua_api_key\u003e\n```\nCaso não tenha uma chave para a API do Groq, leia a [documentação](https://console.groq.com/docs/quickstart)\n\n5. Rode o backend:\n\n```bash\npython app.py\n```\n\nO backend estará rodando em `http://127.0.0.1:5000`.\n\n---\n\n### 2. Frontend\n\n1. Navegue até a pasta do frontend:\n\n```bash\ncd frontend\n```\n\n2. Instale as dependências:\n\n```bash\nnpm install\n```\n\n3. Rode a aplicação:\n\n```bash\nnpm run dev\n```\n\nO frontend estará disponível em `http://localhost:5173`.\n\n---\n\n## 🚀 Como usar\n\n1. Insira o número de WhatsApp do destinatário no campo **Número do WhatsApp**\n2. Escolha as tags se quiser personalizar as mensagens carinhosas do **ZapZap Lovebot**\n3. Clique em **Gerar Mensagem...** para criar uma mensagem fofa com IA\n4. Clique em **Enviar via WhatsApp** para enviar a mensagem diretamente\n\n\u003e ⚠️ O envio depende do WhatsApp Web estar logado no navegador.\n\n---\n\n## 📸 Exemplo de uso\n\n![Exemplo de Uso](img/ex_zapzap.jpg)\n\n---\n\n## ⚠️ Avisos\n\n-   O `pywhatkit` abre o WhatsApp Web automaticamente no navegador.\n-   É necessário estar logado no WhatsApp Web para o envio funcionar.\n-   Use com responsabilidade e carinho.\n\n---\n\n## 📄 Autor\n\nFeito com amor por [Tuchanski](https://github.com/tuchanski) 💕\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuchanski%2Fzapzap-lovebot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftuchanski%2Fzapzap-lovebot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuchanski%2Fzapzap-lovebot/lists"}