Talorys 开源发布：一条命令在 Cloudflare 免费套餐部署个人 AI 智能体

Hacker News：AI 热帖· rociiu·2026-10-10 18:52· 3 小时前AI 评分64

Talorys – 部署在 Cloudflare 免费套餐上的自托管个人 AI 代理

AI 导读

Talorys 是一个免费开源的个人 AI 助手，通过 npx create-talorys@latest 一条命令部署到用户自己的 Cloudflare 账号，完全不经过开发者的服务器或数据库。

正文

你的个人 AI 代理。你自己的云。

Talorys 是一个免费、开源的个人 AI 助手，完全运行在 你自己的 Cloudflare 账号内。它与你聊天、记住重要的事情、管理任务、笔记和项目，并按计划运行提醒和例程—— 无需 Talorys 开发者运营的任何服务器、数据库或账号。

一个人。一个 Cloudflare 账号。一条命令。一个个人 AI 代理。

npx create-talorys@latest

1. Talorys 是什么

一个私密助手——支持流式响应、Markdown 和工具活动指示器的聊天。
记忆——持久保存的个人事实和偏好，你可以查看、编辑和删除。每轮对话只将最相关的记忆发送给模型。
任务、笔记和项目——在 UI 中以及聊天中均可完整增删改查（“添加一个明天审查我项目的任务”）。
自动化——一次性及重复提醒、每日任务摘要和可选的 AI 例程，发送到应用内通知中心。它们运行在 Durable Object 闹钟上，因此无需任何东西保持在线。
设计上为单用户——无注册、无账号、无团队。安装程序设置所有者密码。
无 AI 也能工作——如果 Workers AI 不可用或你的免费配额用尽，任务、笔记、记忆和提醒仍可继续工作。

截图

带工具活动的聊天	任务

记忆（深色模式）	自动化

2. 工作原理

Browser ──HTTPS──▶ Cloudflare Pages (React app + /api Pages Function)
                         │  service binding (no public URL)
                         ▼
                   Private Worker (Hono router)
                         │  getAgentByName("personal-agent")
                         ▼
                   TalorysAgent — Cloudflare Agents SDK Durable Object
                     ├─ SQLite: conversations, memories, tasks, notes, projects,
                     │          automations, sessions, settings, usage
                     ├─ Workers AI: @cf/zai-org/glm-4.7-flash (streaming + tool calling)
                     └─ Alarms: reminders and recurring schedules

浏览器只与你的 *.pages.dev 站点通信。/api/* 请求运行一个 Pages Function，通过 service binding 将它们转发给代理 Worker。
代理 Worker 使用 workers_dev: false 和 preview_urls: false 部署：它没有公开 URL。
身份验证和授权在 Worker 中进行，而非前端。
聊天响应以 Server-Sent Events 端到端流式传输。

更多细节：docs/architecture.md。

3. 使用的 Cloudflare 服务

服务	用途	免费套餐
Cloudflare Pages	前端 + Pages Function	是
Cloudflare Workers	私有 API Worker	是
Durable Objects (SQLite)	所有数据、调度闹钟	是
Workers AI	聊天模型（`@cf/zai-org/glm-4.7-flash`）	是，每日配额

Talorys 不会配置 R2、D1、KV、Vectorize、AI Search、Workflows 或任何付费服务。

4. 部署

npx create-talorys@latest

安装程序：

检查 Node.js（20.18+）并使用其自带的 Wrangler CLI（检测到任何全局安装的 wrangler/cf 但不要求）。
验证你的 Cloudflare 登录，或在浏览器中打开 Cloudflare 的授权页面。
让你选择一个账号（如果你有多个）和一个代理名称。
要求设置所有者密码（隐藏输入，强度检查）。它在本地使用 PBKDF2-SHA256 哈希处理，并仅作为 Cloudflare secret 存储。
生成一个 256 位会话密钥和唯一资源名称（talorys-<id>-agent、talorys-<id>-web）。
部署私有 Worker（创建其 SQLite Durable Object）、存储密钥、创建并部署带有 service binding 的 Pages 项目。
验证实时部署（前端、认证端点、未认证拒绝、存储健康）而不运行任何 AI 推理。
打印 Cloudflare 报告的真实 https://….pages.dev URL。

它会写入一个 talorys/ 目录，其中包含 talorys.json（安装 ID、账户 ID、资源名称、URL——不含机密信息）以及可部署的产物。请保留它以便后续更新。

中断了？ 在同一位置再次运行相同的命令。它会协调已存在的内容：不会产生重复资源，如果密码已配置则不会再次提示输入密码，并且绝不会删除任何数据。

非交互式安装：TALORYS_OWNER_PASSWORD=... npx create-talorys@latest --yes --account-id <id>（如果你未登录，请设置 CLOUDFLARE_API_TOKEN）。

权限

浏览器登录使用 Wrangler 的标准 OAuth 流程——无需 Global API Key。如果你改用 API 令牌，它需要：

账户 › Workers Scripts › 编辑
账户 › Cloudflare Pages › 编辑
账户 › Workers AI › 读取
账户 › 账户设置 › 读取
用户 › 用户详情 › 读取（可选；显示你的电子邮件）

参见 docs/deployment.md。

5. 访问

打开安装程序打印的 URL，输入你的所有者密码，然后开始聊天。你可以从任意数量的设备登录——它们都是同一个所有者。在设置 → 安全中管理会话。

忘记密码了？在你的 talorys/ 目录中：

npx create-talorys@latest reset-password

这会替换密码机密并使所有设备退出登录。

6. 你的数据存储在哪里

所有数据都存储在单个由 SQLite 支持的 Durable Object（personal-agent）中，位于你的 Cloudflare 账户内。Talorys 没有遥测、分析、跟踪或广告代码，也不会向其开发者发送任何内容。

Cloudflare 会处理你的数据以提供其服务——包括对你的聊天消息以及每个提示中包含的相关记忆运行 Workers AI 推理。请查阅 Cloudflare 的隐私政策和 Workers AI 条款。

安全模型和威胁缓解措施：docs/security.md。

7. 哪些是免费的，哪些可能产生费用

Talorys 旨在适配 Cloudflare Workers 免费计划，并且绝不会自行启用付费功能。不过，它并非“无限免费”：

免费计划有账户级配额（请求数、Durable Object 使用量、每日 Workers AI Neuron 分配量）。配额由 Cloudflare 设定，并且可能会变化。
当 AI 分配量耗尽时，聊天会显示一条明确的消息，并在每日重置后恢复。其他一切继续正常工作，你的数据不受影响。
如果你的账户使用的是付费计划，超出包含额度的用量将由 Cloudflare 根据你的计划计费。

内置防护措施（可在设置 → AI中调整）：最大输出 token 数、最大上下文 token 数（较早的历史记录会被摘要）、每个请求的最大工具调用次数和推理步数、每日最大 AI 请求数，以及每日最大计划 AI 运行次数。简单的提醒和任务摘要从不使用 AI。用量面板显示本地估算值，并提供指向 Cloudflare 仪表板的链接以查看确切的 Neuron 用量。

8. 本地开发

要求：Node.js 20.18+。

git clone https://github.com/rociiu/talorys.git
cd talorys
npm install
npm run dev

npm run dev 在一个终端中启动 agent Worker（wrangler dev，端口 8787）、带有服务绑定的 Pages Function 代理（wrangler pages dev，端口 8788）以及 Vite UI（http://localhost:5173）。它会创建一个带有本地密码的 apps/agent/.dev.vars（talorys-dev-password，可通过 TALORYS_DEV_PASSWORD 覆盖），并使用确定性的模拟 AI 提供程序，因此无需登录 Cloudflare。状态持久保存在 .wrangler/state 中。

其他脚本：npm run build、npm test、npm run test:e2e、npm run test:pack、npm run typecheck、npm run lint。参见 docs/development.md。

9. 备份你的数据

设置 → 隐私 → 下载备份会生成 talorys-backup.json，其中包含对话、记忆、任务、笔记、项目、设置和自动化（绝不含会话或凭据）。导入会验证文件并在一个事务中合并它；两次导入同一备份是无害的。

10. 更新

在你的 talorys/ 目录下：

npx create-talorys@latest update

这会将最新的 Worker 和前端重新部署到同一资源。Durable Object 命名空间永远不会被重新创建（迁移是仅追加的），所有者密码和会话会保留，schema 迁移会在首次请求时自动且以事务方式运行。另提供：status 和 doctor。

11. 故障排除

问题	修复
安装程序中途停止	重新运行同一命令；它会继续。
“尚未通过其健康检查”	新的 `pages.dev` 站点可能需要几分钟。请重新运行。
权限错误	使用可编辑 Workers 和 Pages 的账户，或具有上述权限的令牌。
聊天提示 AI 配额已用完	等待每日重置；或在设置 → AI 中启用演示模式。
登录失败后被锁定	等待 15 分钟，或使用 CLI 重置密码。

npx create-talorys@latest doctor 会自动检查一切。更多内容见 docs/troubleshooting.md。

仓库结构

apps/agent              Private Worker: Hono API, TalorysAgent, tools, SQLite repositories
apps/web                React + Vite app, Pages Function (functions/api/[[path]].ts)
packages/shared         Zod schemas, types, recurrence/DST logic, password hashing
packages/create-talorys The one-command installer (npm package)
tests/e2e               Playwright UI tests
tests/smoke             Optional real-account deployment test
docs/                   Architecture, deployment, development, security, troubleshooting

许可证

MIT

来源：Hacker News：AI 热帖 · github.com