开源 · AI 可定制 · 自托管
AI 产品的开源基础设施
多租户认证、计费、支付、积分和管理后台开箱即用。用 AI 围绕你的产品持续迭代，而不是反复搭建基础设施。
terminal
$git clone https://github.com/timzaak/herald.git
$cd herald
$uv run scripts/demo-start.py
→ 正在启动 PostgreSQL + Redis ...
✓ 数据库迁移完成
✓ Multi-tenant 认证 (RBAC, OAuth, TOTP)
✓ 订阅计费 (Stripe, Creem)
✓ 管理后台 @ http://localhost:3000
→ AI 产品基础设施已就绪，开始构建你的独特价值。
AI 产品周围的基础设施
Herald 处理共性的产品底座，让团队把每一次 AI 迭代都用在客户真正愿意付费的产品逻辑上。
多租户认证
相互隔离的 Realm，每个 Realm 拥有独立的用户、角色和 OAuth 提供商。
- 租户数据隔离
- OAuth 2.0 提供商
- TOTP 与 Passkey
RBAC 与客户端应用
每个 Realm 内细粒度的角色权限，应用注册后获得受限凭证。
- Realm 级角色权限
- 客户端应用注册
- 第三方 API 集成
计费与支付
订阅计划与一次性付款，映射到支付提供商并分配给客户端应用。
- 计划与定价层级
- Stripe 与 Creem
- 发票与权益
积分与信用点
多池积分余额，精确计量产品用量。
- 多池消耗
- 发放与配额规则
- 用户交易明细
知情同意与合规
按 Realm 版本化的用户协议与隐私政策，可托管也可外链。
- 版本绑定的重新同意
- 托管或外部页面
- 可审计的账户注销
面向 AI Agent 的 MCP 服务器
Agent 通过受权限约束的工具查询你的租户，无需手写 REST 调用。
- 九个只读工具
- 浏览器 OAuth + 用户级 RBAC
- /mcp/{realmId} Streamable HTTP
三步从代码仓库到 AI 产品
部署底座，用 AI 塑造，构建产品逻辑。
01
Docker 部署
克隆仓库，指向你的域名，运行 dev-start.py。PostgreSQL、Redis、Caddy（自动 TLS）与 Herald 应用在同一台机器上启动。
02
用 AI 塑造产品
通过 AI 辅助开发调整开放代码、产品流程、品牌、角色和集成方式，使底座适配你的市场。
03
构建产品逻辑
通过 Herald 的 API 与 OAuth 2.0 端点接入应用，持续迭代真正让用户愿意付费的 AI 产品体验。
AI 创业团队为何选择 Herald
不止于认证：在一个 AI 可定制的自托管系统中获得计费、支付、积分和完整产品基础设施。
| Herald | Auth0 | Supabase | Keycloak | |
|---|---|---|---|---|
| 多租户认证 | 内置 | 企业版 | 需手动配置 | 内置 |
| 订阅计费 | 内置 | — | — | — |
| 积分与信用点 | 内置 | — | — | — |
| 自托管 | 支持 | 仅云 | 支持 | 支持 |
| 开源 | Apache-2.0 | 否 | 部分 | Apache-2.0 |
常见问题
关于 Herald 你需要知道的一切。
Herald 是什么？
Herald 是 AI 产品的开源、自托管基础设施。它让创业团队从同一套可持续用 AI 改造的代码出发，直接获得多租户认证、RBAC、计费、支付、积分和管理后台。
Herald 如何帮助我更快构建 AI 产品？
你不必把早期迭代花在拼接认证、支付 webhook、权益、积分和管理工具上。Herald 已将这些系统连在一起，团队可以用 AI 改造开放代码，把时间用在自己的产品逻辑上。
Herald 与单纯的认证服务有何不同？
Herald 不只是认证层。它把身份与订阅、一次性支付、权益、积分、发票和租户管理连接起来，让付费访问与产品用量共享同一套底座。
Herald 中的多租户是什么意思？
多租户意味着 Herald 将用户和数据组织到相互隔离的 Realm 中。每个 Realm 是独立的租户，拥有自己的用户、OAuth 提供商、客户端应用和计费计划。Realm 之间的数据完全隔离。
如何部署 Herald？
Herald 通过 Docker 部署。你需要一台 Linux 服务器（Ubuntu 22.04+，2GB 内存）、Docker Engine 24+ 和一个域名。四个容器一起运行：Herald 应用、PostgreSQL、Redis 和 Caddy。
Herald 支持哪些支付提供商？
Herald 支持 Stripe 和 Creem 用于订阅付款。你可以创建不同定价层级的订阅计划，将其映射到特定支付提供商，并分配给客户端应用。
Herald 使用什么技术栈？
Herald 后端使用 Rust（Axum 框架）提供 API，前端使用 React + TypeScript。数据存储在 PostgreSQL 中，使用 SeaORM；Redis 负责会话与缓存。
Herald 是否免费开源？
是的。Herald 采用 Apache-2.0 许可证发布。你可以自由使用、修改和分发，包括商业项目。没有使用限制，也不按用户收费。
评估或部署 Herald 时可以获得帮助吗？
可以。发邮件到 zsy.evan@gmail.com 告诉我们你的产品场景，我们可以协助部署、支付提供商接入和架构问题。Bug 与功能需求也可以提交 GitHub Issue。
构建用户愿意付费的 AI 产品
从开源产品基础设施开始，用 AI 持续定制，把每一次迭代都用在真正让产品与众不同的地方。
有疑问，或正在基于 Herald 构建产品？欢迎邮件联系： zsy.evan@gmail.com