Repolode
Enviar
csr1010

csr1010/wappy-kit

SDK de TypeScript de código abierto para crear un agente de IA autoalojado en WhatsApp, con tu propia clave de modelo y tus datos.

Ver en GitHubSitio web
Estrellas
128
Forks
37
Issues abiertos
1
Último commit
hace 20 horas

¿Qué es?

Wappy es un SDK de TypeScript y un generador de proyectos para crear un agente de IA que conversa con usuarios por WhatsApp a través de la API oficial WhatsApp Cloud. Al ejecutar `npm create @wappy_ai/agent`, se genera un proyecto que conecta el ciclo del agente, la memoria, las llamadas a herramientas y el formato de las respuestas. Tú proporcionas la clave de tu proveedor de modelos (Anthropic, OpenAI, Gemini o un modelo local de Ollama).

De forma predeterminada, las conversaciones y la memoria se almacenan localmente en SQLite/LibSQL, con recuperación BM25 para los documentos incorporados. También puedes elegir Cognee como backend de grafo de conocimiento autoalojado o en la nube. Incluye como ejemplo una herramienta de asistente de Gmail y Google Calendar de solo lectura, que utiliza tus propias credenciales de Google OAuth.

El proyecto aún no ha llegado a la versión 1.0 y está dividido en paquetes: contratos básicos, el harness que ejecuta el agente, un paquete de WhatsApp que se ocupa del formato, los reintentos y los webhooks, y el instalador. La lógica de negocio, como las integraciones de gestión de tickets o reservas, se añade sobre el proyecto generado.

Funciones clave

  • 01Genera un proyecto de agente para WhatsApp con un único comando `npm create`.
  • 02Admite modelos de Anthropic, OpenAI, Gemini y Ollama local con tus propias claves.
  • 03Almacena de forma predeterminada las conversaciones y el conocimiento incorporado localmente en SQLite/LibSQL.
  • 04Ofrece Cognee como backend opcional de grafo de conocimiento autoalojado o en la nube.
  • 05Incluye un ejemplo de herramienta de solo lectura para Gmail y Google Calendar.

Casos de uso

  • Crear un asistente personal privado que recuerde el contexto entre conversaciones de WhatsApp.
  • Responder preguntas sobre tus propias notas o documentos sin enviarlos a una nube de terceros.
  • Prototipar un bot de atención al cliente o reservas al que se pueda acceder por WhatsApp.
  • Ejecutar un agente completamente sin conexión con un modelo local de Ollama.

Inicio rápido

  1. 1

    Genera el proyecto con el instalador

    npm create @wappy_ai/agent
  2. 2

    Copia el archivo de ejemplo de env y añade tu clave de modelo y las credenciales de WhatsApp

    cp .env.sample .env
  3. 3

    Instala las dependencias

    npm install
  4. 4

    Inicia el servidor de desarrollo y abre el túnel; después, configura la URL que aparece como webhook de Meta

    npm run dev

Antes de usarlo

  • El proyecto aún es anterior a la versión 1.0 y está en sus primeras etapas, así que puede cambiar.
  • Requiere Node.js 22 o posterior y una aplicación de WhatsApp Cloud API de Meta.
  • Para ejecutar el agente, necesitas tu propia clave de API del modelo o una instalación local de Ollama.

Temas

#whatsapp#ai-agent#llm#typescript#local-first#chatbot#personal-agent#agent-framework#instinct#muse

Preguntas frecuentes

¿Qué es wappy-kit?
SDK de TypeScript de código abierto para crear un agente de IA autoalojado en WhatsApp, con tu propia clave de modelo y tus datos. Wappy es un SDK de TypeScript y un generador de proyectos para crear un agente de IA que conversa con usuarios por WhatsApp a través de la API oficial WhatsApp Cloud. Al ejecutar `npm create @wappy_ai/agent`, se genera un proyecto que conecta el ciclo del agente, la memoria, las llamadas a herramientas y el formato de las respuestas. Tú proporcionas la clave de tu proveedor de modelos (Anthropic, OpenAI, Gemini o un modelo local de Ollama).
¿wappy-kit es gratuito? ¿Qué licencia tiene?
wappy-kit es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿wappy-kit sigue mantenido?
Mantenimiento activo. El último commit de wappy-kit fue el 21 oct 2026.
¿Para qué puedo usar wappy-kit?
Crear un asistente personal privado que recuerde el contexto entre conversaciones de WhatsApp. Responder preguntas sobre tus propias notas o documentos sin enviarlos a una nube de terceros. Prototipar un bot de atención al cliente o reservas al que se pueda acceder por WhatsApp. Ejecutar un agente completamente sin conexión con un modelo local de Ollama.
¿Cómo se instala wappy-kit?
Genera el proyecto con el instalador: npm create @wappy_ai/agent Copia el archivo de ejemplo de env y añade tu clave de modelo y las credenciales de WhatsApp: cp .env.sample .env Instala las dependencias: npm install Inicia el servidor de desarrollo y abre el túnel; después, configura la URL que aparece como webhook de Meta: npm run dev
¿Dónde consigo wappy-kit?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/csr1010/wappy-kit

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados