novu README

The project's README from github.com/novuhq/novu. As one markdown file: README.md.

Novu Logo

Product Hunt Hacker News NPM npm downloads

The open-source communication infrastructure for agents and products

One API and one unified conversation model to connect your products and your agents to every channel your users live on — Inbox, Email, SMS, Push, Chat, Slack, Microsoft Teams, Telegram, and more.


Learn More »

Report a bug · Docs · Website · Join our Discord · Changelog · Roadmap · X · Contact us

Software is becoming more conversational, and user expectations are rising with it. People no longer want static, irrelevant notifications they glance at and forget, they want to engage, ask questions, and go deeper. Instead of a one-way report dropped in their inbox, they expect a thread they can explore: follow up on a metric, drill into an anomaly, or continue a conversation right where they left off. That shift, from broadcast to meaningful dialog is what Novu's communication infrastructure is built for.

⭐️ Why Novu?

Every product and every agent eventually needs to talk to people, across the channels those people already use. Novu is the open-source layer that handles that communication for you, so you don't rebuild Inbox feeds, provider integrations, and channel webhooks from scratch every time.

There are two ways to build with Novu, and they share the same foundation: a single API and a unified conversation model.

🚀 Getting Started

Create a free account and follow the instructions on the dashboard.

📚 Table of contents

📬 Communication infrastructure for products

The notification platform that turns complex multi-channel delivery into a single component. Built for developers, designed for growth, powered by open source.

Novu provides a unified API to send notifications through multiple channels — Inbox/In-App, Push, Email, SMS, and Chat. Create custom workflows, define per-channel conditions, and let Novu deliver each notification in the most effective way, without stitching together a provider for every channel yourself.

🤖 Agent Communication Infrastructure (ACI)

You build the agent. Novu gives it a voice.

ACI is a complete suite for companies already building agents that need to talk to users on real communication channels. It connects your agent to any channel and abstracts away the quirks of each platform behind a single, unified conversation model.

Novu handles the plumbing in both directions: it receives inbound messages from each channel, normalizes them into one consistent shape, routes them to your agent, and sends your agent's responses back out, so you integrate once instead of building and maintaining a webhook handler per platform.

Want to see ACI in action?

We have built Novu Connect to showcase the power of ACI, build on integrate an existing Claude Managed Agent as a teammate in Slack, Telegram, or Email in less than 2 minutes.

Try it now:

npx novu@latest connect

Embeddable Inbox component

Using the Novu API and admin panel, you can easily add a real-time notification center to your web app without building it yourself. You can use our React, or build your own via our API and SDK. React native, Vue, and Angular are coming soon.

Novu's Embeddable Inbox components

Read more about how to add a notification center Inbox to your app.

Providers

Novu provides a single API to manage providers across multiple channels with a simple-to-use API and UI interface.

Expand a channel below to browse supported providers.

💌 Email (20 providers)
Provider
Amazon SES
Anypost
Braze
Brevo
Custom SMTP
Email Webhook
Email.js
Infobip
MailerSend
Mailgun
Mailjet
Mailtrap
Mandrill
Netcore
Outlook 365
Plunk
Postmark
Resend
SendGrid
SparkPost
📞 SMS (37 providers)
Provider
46elks
Africa's Talking
Afro SMS
Amazon SNS
Azure SMS
Bandwidth
Brevo SMS
Bulk SMS
Burst SMS
Clickatell
ClickSend
CM Telecom
Eazy SMS
Firetext
Generic SMS
Gupshup
iMedia
Infobip
iSend SMS
iSendPro SMS
Kannel
Maqsam
MessageBird
Mobishastra
Plivo
RingCentral
Sendchamp
SimpleTexting
Sinch
SMS Central
SMS77
SMSMode
Telnyx
Termii
Twilio
Unifonic
Vonage
📱 Push (8 providers)
Provider
APNS
App.io
Expo
FCM
OneSignal
Push Webhook
Pusher Beams
Pushpad
💬 Chat (13 providers)
Provider
Chat Webhook
Discord
GetStream
Grafana OnCall
Mattermost
Microsoft Teams
Rocket.Chat
Ryver
Slack
Telegram
Webex Messaging
WhatsApp Business
Zulip
📥 In-App (1 provider)
Provider
Novu Inbox

📋 Read Our Code Of Conduct

Before you begin coding and collaborating, please read our Code of Conduct thoroughly to understand the standards (that you are required to adhere to) for community engagement. As part of our open-source community, we hold ourselves and other contributors to a high standard of communication. As a participant and contributor to this project, you agree to abide by our Code of Conduct.

💻 Need Help?

We are more than happy to help you. If you are getting any errors or facing problems while working on this project, join our Discord server and ask for help. We are open to discussing anything related to the project.

🛡️ License

Novu is a commercial open source company, which means some parts of this open source repository require a commercial license. The concept is called "Open Core," where the core technology is fully open source, licensed under MIT license, and the enterprise code is covered under a commercial license ("/enterprise" Enterprise Edition). Enterprise features are built by the core engineering team of Novu which is hired in full-time.

The following modules and folders are licensed under the enterprise license:

💪 Thanks to all of our contributors

Thanks a lot for spending your time helping Novu grow. Keep rocking 🥂

Contributors

The beatiful header animation was contributed by LottieFiles ❤️

novu (novuhq/novu)

Searching Database…

40.2K ·GitHub
Что это такое?Novu — это инфраструктура для коммуникаций с открытым исходным кодом, которая позволяет продуктам и AI-агентам отправлять сообщения пользователям через Inbox, Email, SMS, Push, Chat, Slack, Microsoft Teams, Telegram, WhatsApp и другие каналы — через один API и единую модель диалога.
Это библиотека, которую я импортирую, или хостируемая платформа с панелью управления?Это полноценная платформа: API и панель администратора для создания многоканальных сценариев уведомлений, а также встраиваемый React-компонент входящих, который вы подключаете к своему приложению, и отдельный слой ACI для подключения агентов к чат-каналам.
Как начать работу с Novu?Самый быстрый путь — создать бесплатный аккаунт и следовать инструкциям по настройке в панели управления Novu; также можно развернуть систему самостоятельно, запустив проект локально из репозитория.
Что нужно установить, чтобы запустить это самостоятельно?Для монорепозитория требуются Node.js 22 и pnpm 11; сборка и управление выполняются с помощью Nx, а код разбит на множество внутренних пакетов (API, worker, websockets, dashboard и др.).
Всё ли это действительно бесплатно и с открытым исходным кодом?Ядро распространяется под лицензией MIT и полностью открыто, но папка `/enterprise` и её модули защищены отдельной коммерческой лицензией — Novu называет эту модель «open core».
Для кого это — для разработчиков приложений или для создателей агентов?Для обоих: продуктовые команды используют это как классическую многоканальную инфраструктуру уведомлений, а команды, создающие AI-агентов, применяют Agent Communication Infrastructure (ACI), чтобы дать любому агенту возможность общаться в Slack, Teams, Telegram, WhatsApp или по Email.
Какие фреймворки можно использовать для встраиваемого окна входящих прямо сейчас?Встраиваемый компонент уведомлений сейчас доступен только для React; поддержка React Native, Vue и Angular заявлена как скоро.
Что именно представляет собой ACI (Agent Communication Infrastructure)?ACI приводит входящие и исходящие сообщения из каналов вроде Slack, Teams, Telegram, WhatsApp и Email к единой модели диалога, поэтому разработчику достаточно интегрироваться один раз, а не писать отдельный обработчик вебхуков для каждой платформы для своего агента.
Сколько провайдеров сообщений Novu поддерживает из коробки?В README перечислены 20 провайдеров email (SendGrid, Mailgun, SES, Postmark и др.), 37 провайдеров SMS (Twilio, Vonage, MessageBird и др.), 8 провайдеров push-уведомлений (FCM, APNS, OneSignal и др.) и 13 провайдеров чатов (Slack, Discord, Teams, Telegram, WhatsApp Business и др.).
Для чего нужен движок дайджестов?Он объединяет несколько отдельных событий-уведомлений в одно общее сообщение, чтобы пользователи не получали множество отдельных уведомлений о связанных событиях.
Создаёт ли Novu сам AI-агента?Нет — Novu прямо описан как слой подключения каналов, а не как агент; он работает с любым стеком агентов, который вы уже создали, включая Claude Managed Agents, AI SDK или LangGraph.
Creator
novuhq
Size
501.6 MB
Stars
40.2K
Age
5y
Commits · 90 Days