rociiu/talorys

选用指南

AI 根据 README 整理 · 2026/10/11 13:01:15

适用场景

适合希望将个人 AI 助手部署在自己的 Cloudflare 账户中，用于聊天、任务、笔记和定时提醒的场景。

查看 README 依据

# Talorys **Your personal AI agent. Your own cloud.** Talorys is a free, open-source personal AI assistant that runs entirely inside **your own Cloudflare account**. It chats with you, remembers what matters, manages tasks, notes and projects, and runs reminders and routines on a schedule — without any server, database or account operated by the Talorys developers. One person. One Cloudflare account. One command. One personal AI agent. ```bash npx create-talorys@latest ``` --- ## 1. What Talorys is

- **A private assistant** — chat with streaming responses, Markdown and tool activity indicators. - **Memory** — durable personal facts and preferences you can view, edit and delete. Only the most relevant memories are sent to the model on each turn. - **Tasks, notes and projects** — full CRUD in the UI, and from chat ("Add a task to review my project tomorrow"). - **Automations** — one-time and recurring reminders, daily task digests and optional AI routines, delivered to an in-app notification center. They run on Durable Object alarms, so nothing has to stay online.

目标用户

面向单用户，无需注册或团队功能，适合个人使用。

查看 README 依据

- **Single-user by design** — no signup, no accounts, no teams. The installer sets the owner password. - **Works without AI** — tasks, notes, memories and reminders keep working if Workers AI is unavailable or your free quota is used up. ### Screenshots | Chat with tool activity | Tasks | | --- | --- | |  |  | | **Memory (dark mode)** | **Automations** | |  |  |

使用方式

通过浏览器访问部署后的页面，使用聊天、任务、笔记等功能，也可通过命令行安装和更新。

查看 README 依据

(with `CLOUDFLARE_API_TOKEN` set if you are not logged in). ### Permissions Browser login uses Wrangler's standard OAuth flow — no Global API Key. If you use an API token instead, it needs: - Account › Workers Scripts › Edit - Account › Cloudflare Pages › Edit - Account › Workers AI › Read - Account › Account Settings › Read - User › User Details › Read (optional; shows your email) See [docs/deployment.md](docs/deployment.md). ## 5. Access Open the URL the installer prints, enter your owner password, and start chatting.

one transaction; importing the same backup twice is harmless. ## 10. Update From your `talorys/` directory: ```bash npx create-talorys@latest update ``` This redeploys the latest Worker and frontend to the **same** resources. The Durable Object namespace is never recreated (migrations are append-only), the owner password and sessions are kept, and schema migrations run automatically and transactionally on first request. Also available: `status` and `doctor`. ## 11. Troubleshooting | Problem | Fix | | --- | --- | | Installer stopped midway | Re-run the same command; it resumes. |

部署要求

需要 Node.js 22+ 和 Cloudflare 账户，部署在 Cloudflare Pages、Workers 和 Durable Objects 上，使用 Workers AI 提供聊天模型。

查看 README 依据

Talorys does **not** provision R2, D1, KV, Vectorize, AI Search, Workflows or any paid service. ## 4. Deploy ```bash npx create-talorys@latest ``` The installer: 1. Checks Node.js (22+) and uses its bundled Wrangler CLI (any globally installed `wrangler`/`cf` is detected but not required). 2. Verifies your Cloudflare login, or **opens Cloudflare's authorization page in your browser**. 3. Lets you choose an account (if you have several) and an agent name.

Simple reminders and task digests never use AI. The Usage panel shows local **estimates** and links to the Cloudflare dashboard for exact Neuron usage. ## 8. Local development Requirements: Node.js 22+. ```bash git clone https://github.com/rociiu/talorys.git cd talorys npm install npm run dev ``` `npm run dev` starts the agent Worker (`wrangler dev`, port 8787), the Pages Function proxy with its service binding (`wrangler pages dev`, port 8788) and the Vite UI (http://localhost:5173) in one terminal. It creates `apps/agent/.dev.vars` with a local password (`talorys-dev-password`, override

已知限制

免费计划有配额限制，AI 分配用尽后聊天会暂停，但其他功能仍可用。

查看 README 依据

Workers AI Neuron allocation). Quotas are set by Cloudflare and can change. - When the AI allocation is exhausted, chat shows a clear message and resumes after the daily reset. Everything else keeps working, and your data is untouched. - If your account is on a paid plan, usage beyond included amounts is billed by Cloudflare under your plan. Built-in guardrails (adjustable in **Settings → AI**): max output tokens, max context tokens (older history is summarized), max tool calls and reasoning steps per request, max AI requests per day, and max scheduled AI runs per day.