Framework de agente pessoal de IA self-hosted em Python, com WebUI no navegador, cliente de terminal, canais de chat, ferramentas, memória e suporte a MCP.
49,2 mil8,7 milPythonMITAtualizado anteontem
csr1010/wappy-kit
SDK open source em TypeScript para criar um agente de IA auto-hospedado no WhatsApp, usando sua própria chave de modelo e seus próprios dados.
- Estrelas
- 128
- Forks
- 37
- Issues abertas
- 1
- Último commit
- há 20 horas
O que é?
Wappy é um SDK e gerador de projetos em TypeScript para criar um agente de IA que conversa com usuários pelo WhatsApp usando a API oficial do WhatsApp Cloud. O comando `npm create @wappy_ai/agent` gera um projeto que configura o ciclo do agente, a memória, o uso de ferramentas e a formatação das respostas. Você fornece a chave do seu provedor de modelo (Anthropic, OpenAI, Gemini ou um modelo local do Ollama).
Por padrão, as conversas e a memória ficam armazenadas localmente em SQLite/LibSQL, com busca BM25 para documentos ingeridos. Também é possível escolher o Cognee como backend de grafo de conhecimento auto-hospedado ou na nuvem. O projeto inclui um exemplo opcional de assistente para Gmail e Google Calendar, com ferramentas somente de leitura e usando suas próprias credenciais do Google OAuth.
O projeto ainda está antes da versão 1.0 e é dividido em pacotes: contratos centrais, o harness que executa o agente, um pacote de WhatsApp que cuida da formatação, das tentativas e dos webhooks, além do instalador. Sua lógica de negócio, como integrações de tickets ou reservas, é adicionada sobre o projeto gerado.
Recursos principais
- 01Gera um projeto de agente para WhatsApp com um único comando `npm create`.
- 02Oferece suporte a modelos da Anthropic, OpenAI e Gemini, além de modelos locais do Ollama, usando suas próprias chaves.
- 03Armazena conversas e conhecimento ingerido localmente em SQLite/LibSQL por padrão.
- 04Disponibiliza o Cognee como backend opcional de grafo de conhecimento, auto-hospedado ou na nuvem.
- 05Inclui um exemplo de ferramenta somente de leitura para Gmail e Google Calendar.
Casos de uso
- Criar um assistente pessoal privado que mantém o contexto entre conversas no WhatsApp.
- Responder a perguntas sobre suas próprias anotações ou documentos sem enviá-los para a nuvem de terceiros.
- Criar um protótipo de bot de suporte ao cliente ou de reservas acessível pelo WhatsApp.
- Executar um agente totalmente offline com um modelo local do Ollama.
Início rápido
- 1
Gere o projeto com o instalador
npm create @wappy_ai/agent - 2
Copie o arquivo de exemplo de env e preencha sua chave de modelo e as credenciais do WhatsApp
cp .env.sample .env - 3
Instale as dependências
npm install - 4
Inicie o servidor de desenvolvimento e abra o túnel; depois, configure a URL exibida como webhook da Meta
npm run dev
Antes de usar
- O projeto ainda é anterior à versão 1.0 e está nos primeiros estágios, então espere mudanças.
- É necessário ter Node.js 22 ou superior e um app do WhatsApp Cloud API da Meta.
- Para executar o agente, você precisa da sua própria chave de API do modelo ou de uma instalação local do Ollama.
Tópicos
Perguntas frequentes
- O que é wappy-kit?
- SDK open source em TypeScript para criar um agente de IA auto-hospedado no WhatsApp, usando sua própria chave de modelo e seus próprios dados. Wappy é um SDK e gerador de projetos em TypeScript para criar um agente de IA que conversa com usuários pelo WhatsApp usando a API oficial do WhatsApp Cloud. O comando `npm create @wappy_ai/agent` gera um projeto que configura o ciclo do agente, a memória, o uso de ferramentas e a formatação das respostas. Você fornece a chave do seu provedor de modelo (Anthropic, OpenAI, Gemini ou um modelo local do Ollama).
- wappy-kit é gratuito? Qual é a licença?
- wappy-kit é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- wappy-kit ainda é mantido?
- Manutenção ativa. O último commit de wappy-kit foi em 21 de out. de 2026.
- Para que posso usar wappy-kit?
- Criar um assistente pessoal privado que mantém o contexto entre conversas no WhatsApp. Responder a perguntas sobre suas próprias anotações ou documentos sem enviá-los para a nuvem de terceiros. Criar um protótipo de bot de suporte ao cliente ou de reservas acessível pelo WhatsApp. Executar um agente totalmente offline com um modelo local do Ollama.
- Como instalar wappy-kit?
- Gere o projeto com o instalador: npm create @wappy_ai/agent Copie o arquivo de exemplo de env e preencha sua chave de modelo e as credenciais do WhatsApp: cp .env.sample .env Instale as dependências: npm install Inicie o servidor de desenvolvimento e abra o túnel; depois, configure a URL exibida como webhook da Meta: npm run dev
- Onde consigo wappy-kit?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/csr1010/wappy-kit
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Assistente pessoal de IA local-first, feito em Python legível, com loop de agente próprio, memória baseada em SQLite e evals integradas.
2,1 mil410PythonMITAtualizado há 11 dias
Um agente pessoal de IA open source com quem você conversa por iMessage, executado em seu próprio desktop na nuvem e coordenado com os agentes de outras pessoas.
38379TypeScriptMITAtualizado ontem
Assistente pessoal de IA e Agent Harness de código aberto que planeja tarefas, executa ferramentas e skills e mantém memória em canais Web e de mensagens instantâneas.
47,5 mil10,4 milPythonMITAtualizado anteontem
Distribuição do OpenClaw localizada para chinês simplificado: um assistente pessoal de IA open source que roda no seu computador e funciona por apps de chat.
3,8 mil491JavaScriptOtherAtualizado há 3 dias
Uma plataforma de agentes self-hosted em Rust que funciona como assistente sempre ativo em canais de chat, na Web e em APIs, com app desktop nativo e SDK incorporável.
748137RustMITAtualizado há 4 dias