What you can do with Wappy Kit

4 use cases

• Run a personal WhatsApp assistant that remembers you

  A self-hosted agent on your own machine that keeps session context across days of chats.

  • Wappy Kit
  • Personal productivity
  • Intermediate
  View prompt

  In the csr1010/wappy-kit repo, scaffold a project with `npm create @wappy_ai/agent` into ./<project-dir>. Expected output: a generated project folder with a .env.sample listing the model key and WhatsApp fields. Verify that no files were written outside ./<project-dir>.

  Share Save

• Ask WhatsApp about your Gmail and Calendar

  Text the bot in plain English to find emails or check your calendar, using your own Google account.

  • Wappy Kit
  • Personal productivity
  • Intermediate
  View prompt

  In the csr1010/wappy-kit repo, scaffold a project with `npm create @wappy_ai/agent` into ./<project-dir> and choose the productivity agent. Expected output: a project that includes the Gmail/Calendar tools and a local Google connect page. Verify that the generated tools are read-only and that no send or delete function was added.

  Share Save

• Answer questions from your own notes over WhatsApp

  Ingest your notes into a local knowledge base and ask about them from WhatsApp, fully offline.

  • Wappy Kit
  • Personal productivity
  • Intermediate
  View prompt

  In the csr1010/wappy-kit repo, scaffold a project with `npm create @wappy_ai/agent` into ./<project-dir> and choose the local knowledge backend. Expected output: a generated project with a Knowledge/RAG layer backed by SQLite/LibSQL. Verify that the knowledge backend setting in the generated config is local and that no external service URL is required.

  Share Save

• Build a support agent that works your ticket system

  Wire your own ticketing tools into a WhatsApp agent so customers get fixes, not just an email form.

  • Wappy Kit
  • Personal productivity
  • Advanced
  View prompt

  In the csr1010/wappy-kit repo, scaffold a project with `npm create @wappy_ai/agent` into ./<project-dir>, then add one tool that calls a ticketing API at <ticketing-api-url>. Expected output: a tool that returns a ticket status to the agent. Verify that the test call uses a sandbox ticket account and not production data.

  Share Save

How to use Wappy Kit

1. Check you have what it needs: Node.js 22 or newer; A WhatsApp Cloud API app from Meta's developer portal with a phone number, access token, and app secret; A model API key from OpenAI, Anthropic, or Gemini, or a local Ollama install.
2. Open csr1010/wappy-kit on GitHub and read the README and license.
3. Run npm create @wappy_ai/agent and answer the setup questions.
4. Run cp .env.sample .env and add your model key and WhatsApp credentials.
5. Run npm install.
6. Run npm run dev and copy the printed tunnel URL into Meta's webhook configuration.

These steps come from our top use case, Run a personal WhatsApp assistant that remembers you, which also has a copy-paste agent prompt.

Wappy Kit alternatives · Best AI repos for Personal productivity

About this repo

• Who it is forDevelopers and small teams who want a private AI assistant on WhatsApp using their own model key, WhatsApp number, and data.
• Why it is hot
• LanguageTypeScript
• Sourcegithub.com/csr1010/wappy-kit · Back to Hot repos

Requirements

• Node.js 22 or newer
• A WhatsApp Cloud API app from Meta's developer portal with a phone number, access token, and app secret
• A model API key from OpenAI, Anthropic, or Gemini, or a local Ollama install
• A Google account, only if you use the Gmail/Calendar assistant

Related repos

• Trended earlier Abacusai Bot AbacusAI Bot is a free, open-source desktop app for creating standing personal agents that you can message from WhatsApp, Telegram, Discord, or the desktop and connect to work services.
• Trended earlier Unigit Ecosystem UNIGIT's public brand and ecosystem hub, which explains the product direction and gives builders, partners, and users a way to recommend resources and propose partnerships.
• Trended earlier Comma Comma is an open-source, always-on personal agent that turns goals into persistent Tasks, runs them in agent loops, and works across your computers, phone, and cloud.