csr1010/whatsapp-ai-agent-sdk

Что это?

Ключевые возможности

• 01Создаёт проект WhatsApp-агента одной командой `npm create`.
• 02Поддерживает Anthropic, OpenAI, Gemini и локальные модели Ollama с вашими собственными ключами.
• 03По умолчанию локально хранит переписки и загруженные знания в SQLite/LibSQL.
• 04Предлагает Cognee в качестве дополнительной self-hosted или облачной системы хранения знаний в виде графа.
• 05Включает пример инструмента для Gmail и Google Calendar с доступом только для чтения.

Сценарии использования

• Создание приватного персонального помощника, который сохраняет контекст между переписками в WhatsApp.
• Ответы на вопросы по собственным заметкам и документам без отправки их в облако стороннего поставщика.
• Создание прототипа бота для поддержки клиентов или бронирования, доступного через WhatsApp.
• Запуск полностью офлайн-агента на локальной модели Ollama.

Быстрый старт

1. 1

   Создайте проект с помощью установщика

   npm create @wappy_ai/agent
2. 2

   Скопируйте образец env-файла и укажите ключ модели и учетные данные WhatsApp

   cp .env.sample .env
3. 3

   Установите зависимости

   npm install
4. 4

   Запустите сервер разработки и откройте туннель, затем укажите напечатанный URL в качестве вебхука Meta

   npm run dev

Что важно знать

• !Проект пока не достиг версии 1.0 и находится на раннем этапе, поэтому возможны изменения.
• !Требуются Node.js 22 или новее и приложение WhatsApp Cloud API от Meta.
• !Для запуска агента нужен собственный API-ключ модели или локальная установка Ollama.

В подборках

Темы

Частые вопросы

Что такое whatsapp-ai-agent-sdk?

Open-source TypeScript SDK для создания self-hosted AI-агента в WhatsApp с собственным ключом модели и данными. Wappy — это TypeScript SDK и генератор проектов для создания AI-агента, который общается с пользователями через WhatsApp с помощью официального WhatsApp Cloud API. Команда `npm create @wappy_ai/agent` создаёт проект, в котором настроены цикл работы агента, память, вызов инструментов и форматирование ответов. Вам нужно указать собственный ключ провайдера модели: Anthropic, OpenAI, Gemini или локальной модели Ollama.

whatsapp-ai-agent-sdk можно использовать бесплатно? Какая у него лицензия?

whatsapp-ai-agent-sdk распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

whatsapp-ai-agent-sdk всё ещё поддерживается?

Активно поддерживается. Последний коммит в whatsapp-ai-agent-sdk — 2 нояб. 2026 г..

Для чего можно использовать whatsapp-ai-agent-sdk?

Создание приватного персонального помощника, который сохраняет контекст между переписками в WhatsApp. Ответы на вопросы по собственным заметкам и документам без отправки их в облако стороннего поставщика. Создание прототипа бота для поддержки клиентов или бронирования, доступного через WhatsApp. Запуск полностью офлайн-агента на локальной модели Ollama.

Как установить whatsapp-ai-agent-sdk?

Создайте проект с помощью установщика: npm create @wappy_ai/agent Скопируйте образец env-файла и укажите ключ модели и учетные данные WhatsApp: cp .env.sample .env Установите зависимости: npm install Запустите сервер разработки и откройте туннель, затем укажите напечатанный URL в качестве вебхука Meta: npm run dev

Где скачать whatsapp-ai-agent-sdk?

Исходный код и инструкции по установке — на GitHub: https://github.com/csr1010/whatsapp-ai-agent-sdk