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)

chat
Searching Database…

40.2K ·GitHub
Novu
What is this?Novu is open-source communication infrastructure that lets products and AI agents send messages to users across Inbox, Email, SMS, Push, Chat, Slack, Microsoft Teams, Telegram, WhatsApp and more through one API and one unified conversation model.
Is this a library I import, or a hosted platform with a dashboard?It is a full platform: an API and admin dashboard for building multi-channel notification workflows, plus an embeddable React inbox component you drop into your app, and a separate ACI layer for connecting agents to chat channels.
How do I get started with Novu?The quickest path is to create a free account and follow the setup instructions on the Novu dashboard; you can also self-host it by running the project locally from the repo.
What do I need installed to run it myself?The monorepo requires Node.js 22 and pnpm 11, and is built/managed with Nx across many internal packages (API, worker, websockets, dashboard, etc.).
Is all of this actually free and open source?The core is MIT-licensed and fully open, but the `/enterprise` folder and its modules are covered by a separate commercial license — Novu calls this an 'open core' model.
Who is this for — app developers or agent builders?Both: product teams use it as classic multi-channel notification infrastructure, while teams building AI agents use the Agent Communication Infrastructure (ACI) to give any agent a voice on Slack, Teams, Telegram, WhatsApp or Email.
Which frameworks can I use for the embeddable inbox right now?The embeddable notification inbox component currently ships for React; React Native, Vue, and Angular support is listed as coming soon.
What exactly is ACI (Agent Communication Infrastructure)?ACI normalizes inbound and outbound messages from channels like Slack, Teams, Telegram, WhatsApp and Email into one consistent conversation model, so a developer integrates once instead of writing a webhook handler per platform for their agent.
How many messaging providers does Novu support out of the box?README lists 20 email providers (SendGrid, Mailgun, SES, Postmark, etc.), 37 SMS providers (Twilio, Vonage, MessageBird, etc.), 8 push providers (FCM, APNS, OneSignal, etc.), and 13 chat providers (Slack, Discord, Teams, Telegram, WhatsApp Business, etc.).
What is the digest engine for?It batches multiple individual notification events into a single combined message, so users do not get spammed with separate notifications for related events.
Does Novu build the AI agent itself?No — Novu is explicitly described as the channel-connecting layer, not the agent; it works with whatever agent stack you already built, including Claude Managed Agents, AI SDK, or LangGraph.
What are similar projects?fleetbase, buzzkit, apprise, logto, OpenExecutive, evenfire, mail2telegram, daily_stock_analysis
Which topics is it in?sms, push-notifications, communication, webhooks, angular, reactjs, notifications, slack, infrastructure, messaging, discord, saas
Creator
novuhq
Size
501.5 MB
Stars
40.2K
Updated
CommitOct 16Release@novu/[email protected]Sep 28
Age
5y
Commits · 90 Days