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 智能体可以通过一个 API 和一套统一的会话模型,向用户发送消息,支持的渠道包括站内信、电子邮件、短信、推送、聊天、Slack、Microsoft Teams、Telegram、WhatsApp 等。
这是我要导入的库,还是带控制台的托管平台?它是一个完整的平台:包含一个 API 和管理控制台,用于搭建多渠道通知工作流;另外还提供一个可嵌入的 React 站内信组件,可以直接放进你的应用中;此外还有一个独立的 ACI 层,用于把智能体接入聊天渠道。
我该如何开始使用 Novu?最快的方式是免费创建一个账户,然后按照 Novu 控制台上的设置说明操作;如果想自行托管,也可以从代码仓库克隆项目,在本地运行。
要自己运行它,需要先安装什么?这个单体仓库需要 Node.js 22 和 pnpm 11,并使用 Nx 进行构建和管理,内部包含许多子包(如 API、工作进程、WebSocket、控制台等)。
这些功能真的都是免费且开源的吗?核心部分采用 MIT 许可证,完全开源;但 `/enterprise` 文件夹及其模块适用单独的商业许可证。Novu 将这种模式称为“开放核心”(open core)。
这是给应用开发者用的,还是给智能体开发者用的?两者都适用:产品团队可以把它当作传统的多渠道通知基础设施使用;而开发 AI 智能体的团队则可以借助智能体通讯基础设施(ACI),让任何智能体在 Slack、Teams、Telegram、WhatsApp 或电子邮件中“发声”。
目前可嵌入的站内信组件支持哪些框架?可嵌入的通知站内信组件目前只提供 React 版本;React Native、Vue 和 Angular 的支持已列入计划,即将推出。
ACI(智能体通讯基础设施)到底是什么?ACI 会把 Slack、Teams、Telegram、WhatsApp 和电子邮件等渠道的收发消息统一成同一套会话模型,因此开发者只需集成一次,无需为智能体逐个平台编写 webhook 处理程序。
Novu 开箱即用支持多少家消息服务商?README 列出了 20 家邮件服务商(如 SendGrid、Mailgun、SES、Postmark 等)、37 家短信服务商(如 Twilio、Vonage、MessageBird 等)、8 家推送服务商(如 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