ForkFree

AI agents and automation

whatsapp-ai-agent-sdk

by csr1010

A TypeScript toolkit for building an AI agent that chats on WhatsApp, running on your own machine with your own model key and WhatsApp number. It is for people who want a customer-facing or personal assistant on WhatsApp without handing their data to a third-party cloud.

Proof level: ReadHidden gemWorth a lookMIT

Get it on GitHubProject websiteCompare

No demo yet

Proof level: Read. We read its README and licence and ran our automatic checks. We have not run it yet. So this page is based on its README and our automatic checks.

The catch

Hidden gemIt scaffolds a self-hosted WhatsApp AI agent with one command, covering the fiddly parts (webhook server, tunnel, message formatting, retries, memory, local RAG) and letting you choose Anthropic, OpenAI, Gemini or local Ollama. For a small business wanting a support or booking bot without a hosted platform, it could save days of plumbing. Best for developers or freelancers building self-hosted WhatsApp bots for clients.
Worth a lookEstablished, with a few things to check (listed below).

Check this first: Early, pre-1.0 project, so expect changes.

Things to check

  • Early, pre-1.0 project, so expect changes
  • Needs a paid model API key unless you run local Ollama
  • Requires a Meta WhatsApp Cloud API app and a phone number, with Meta's own terms and setup
  • Business tools such as ticketing or booking are not pre-built; you must wire them up yourself

Can you use whatsapp-ai-agent-sdk commercially?

Free to use, change and sell, including in paid products. Keep the copyright notice.

Not legal advice. Read the project's licence file before building a product on it.

What can you do with whatsapp-ai-agent-sdk?

  • Generate a working WhatsApp agent project with one command and connect it to Anthropic, OpenAI, Gemini or local Ollama
  • Ask the bot about your Gmail and Google Calendar in plain English, using the read-only sample tool
  • Ingest your own notes or documents so the agent answers questions from them

How do you get whatsapp-ai-agent-sdk running?

Run `npm create @wappy_ai/agent`, fill in a .env file with your model key and WhatsApp Cloud API credentials, then `npm install` and `npm run dev` (Node.js 22+ needed).

Follow the official instructions in the project README.

Make money with it

A freelancer could build and host custom WhatsApp support or booking bots for local businesses and charge a setup fee plus monthly maintenance.

An idea, not financial advice. Check the licence before charging for anything built on it.

Ways a business could use it

  • Run a WhatsApp support agent that answers customer questions from your own documents, cutting time spent on repetitive messages
  • Offer a booking assistant for a restaurant, clinic or studio, connected to your reservations system

Checked 12 Nov 2026. Summary drafted by AI from the project's README. Proof level 1 of 4, Read: we read its readme and licence and ran our automatic checks. we have not run it yet.

Similar tools in AI agents and automation

craft-anything storytold
New and promising

Craft Anything is a desktop app and command-line tool that studies how a website, app or game works, then uses a coding agent to build your own version and check it against the original. It is meant for people who want to recreate or learn from existing software without writing it all by hand.

Proof level: Read 38.9k stars +2044 a day Apache-2.0
dsh-Go ccch1mneyyy
New and promising

DSH Go is an unofficial Android app that runs the DeepSeek Harness coding agent on your phone, or lets you control a copy running on your computer or server. It gives you a chat interface for talking to AI models, approving tool actions and sharing conversations.

Proof level: Read 28.6k stars +1280 a day AGPL-3.0
orca stablyai
Worth a look

Orca is a desktop app, with a phone companion, for running several AI coding agents side by side, each in its own git worktree. It lets you track, review and steer their work from one place.

Proof level: Read 130.3k stars +936 a day MIT