csr1010/wappy-kit

What is it?

Key features

• 01Generates a WhatsApp agent project with one `npm create` command.
• 02Supports Anthropic, OpenAI, Gemini, and local Ollama models with your own keys.
• 03Stores conversations and ingested knowledge locally in SQLite/LibSQL by default.
• 04Offers Cognee as an optional self-hosted or cloud knowledge graph backend.
• 05Includes a read-only Gmail and Google Calendar tool example.

Use cases

• Building a private personal assistant that remembers context across WhatsApp conversations.
• Answering questions over your own notes or documents without sending them to a third-party cloud.
• Prototyping a customer support or booking bot reachable on WhatsApp.
• Running a fully offline agent against a local Ollama model.

Quick start

1. 1

   Generate the project with the installer

   npm create @wappy_ai/agent
2. 2

   Copy the env sample and fill in your model key and WhatsApp credentials

   cp .env.sample .env
3. 3

   Install dependencies

   npm install
4. 4

   Start the dev server and open the tunnel, then set the printed URL as Meta's webhook

   npm run dev

Things to know

• !The project is pre-1.0 and still in early days, so expect changes.
• !It requires Node.js 22 or newer and a WhatsApp Cloud API app from Meta.
• !You need your own model API key, or a local Ollama setup, to run the agent.

Topics

FAQ

What is wappy-kit?

Open-source TypeScript SDK for building a self-hosted AI agent that runs on WhatsApp, with your own model key and data. Wappy is a TypeScript SDK and project generator for building an AI agent that talks to users over WhatsApp through the official WhatsApp Cloud API. Running `npm create @wappy_ai/agent` produces a project that wires up the agent loop, memory, tool calling and reply formatting, and you supply your own model provider key (Anthropic, OpenAI, Gemini, or a local Ollama model).

Is wappy-kit free to use? What license does it have?

wappy-kit is open source under the MIT license. Check the license terms before using it in commercial products.

Is wappy-kit still maintained?

Actively maintained. The last commit to wappy-kit was on Oct 21, 2026.

What can I use wappy-kit for?

Building a private personal assistant that remembers context across WhatsApp conversations. Answering questions over your own notes or documents without sending them to a third-party cloud. Prototyping a customer support or booking bot reachable on WhatsApp. Running a fully offline agent against a local Ollama model.

How do I install wappy-kit?

Generate the project with the installer: npm create @wappy_ai/agent Copy the env sample and fill in your model key and WhatsApp credentials: cp .env.sample .env Install dependencies: npm install Start the dev server and open the tunnel, then set the printed URL as Meta's webhook: npm run dev

Where can I get wappy-kit?

The source code and installation instructions are on GitHub: https://github.com/csr1010/wappy-kit