novuhq/novu

项目介绍

Novu 是位于应用或智能体与用户实际阅读渠道之间的一层开源通信基础设施。你不需要为收件箱、邮件、短信、推送和聊天分别对接并维护供应商，只需发一次 API 请求，由 Novu 完成投递。

两类场景共用同一套底座，即一个 API 和一个统一会话模型：

• 产品通知：覆盖 In-App/Inbox、Email、SMS、Push 和 Chat，提供支持分支与按渠道条件的 workflow 引擎、用于批量合并消息的 digest 引擎、无代码邮件编辑器，以及可嵌入的 <Inbox /> 和偏好设置组件。
• Agent Communication Infrastructure（ACI）：把你已经构建好的智能体接到 Slack、Microsoft Teams、Telegram、WhatsApp、邮件和应用内收件箱。它接收各渠道的入站消息，归一化为统一消息结构后路由给你的智能体，再把回复发回渠道，省去为每个平台单独编写 webhook 处理逻辑。

Provider 覆盖较广：仓库内 packages/providers/src/lib/ 下提供 20 个邮件、37 个短信、8 个推送和 13 个聊天渠道适配器。主要面向需要在产品中加入通知中心的产品团队，以及希望把现有智能体接入聊天渠道的团队。

快速使用

README 给出的入门路径以账号优先：从 Novu 控制台创建免费账号，然后按控制台中的指引操作。这是使用产品通知的最短路径，无需自行运行后端。

想体验 ACI，README 提供了一条 CLI 命令，把已有的 Claude Managed Agent 接入 Slack、Telegram 或 Email：

npx novu@latest connect

按 README 的定位，这是通过 Novu Connect 演示 ACI 能力，而不是完整的智能体构建教程。如果在 React 应用中接入通知平台，可参考 React quickstart，使用 @novu/react 添加实时收件箱组件。

项目也支持自托管，步骤单独记录在本地运行指南中；README 未包含这些步骤，应将其视为需要自行准备环境依赖的另一条部署路径。

使用约束

• 文档中的客户端路径是 React 收件箱组件；React Native、Vue 和 Angular 在 README 中标注为即将推出。
• 仓库采用 Open Core 模式：核心部分为 MIT 许可，但根目录 enterprise 文件夹及其子目录使用商业许可，复用前需确认许可范围。
• ACI 不负责构建智能体。智能体逻辑仍由 Claude Managed Agents、AI SDK、LangGraph 或自研栈承担，Novu 只处理渠道连接。
• 各渠道凭据需由开发者自行准备。2022 年的一次讨论中，维护者确认当时不提供 Slack/Teams 的 OAuth 接入流程，仅将其列入路线图。

HotRepo 点评

Novu 最明确的站外信号来自 2022 年 12 月 Hacker News 上一则题为「Service for managing multi-channel notifications with a single API」的讨论，获得 160 分、24 条评论，讨论中提出的核心问题至今仍有参考价值：是否有人在大规模生产环境中使用？两位评论者追问生产经验，在已有回复样本中未得到直接答复，说明单一 API 的价值被认可，但该讨论未能证明规模化落地。TypeScript 日榜在 2026-11-06 的快照记录当天新增 22 Star、排名第 14，属于单日读数，不足以判断趋势。2026 年的 README 已将叙事从通知投递扩展到智能体通信渠道，如果把它当基础设施评估，这一范围变化值得留意。