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.

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.
• Semantic recall (optional) — finds memories by meaning as well as keyword, and lists them newest first with their saved date. Off by default; turn it on with the Semantic memory recall switch near the bottom of Settings → AI (its other settings appear once it is on), or install with --semantic. See docs/semantic-recall.md.
• Memory history — facts that change over time: when you say you sold your car, the old one is kept as a past fact instead of being treated as current, and unclear conflicts wait for your review. See docs/memory-history.md.
• 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.
• 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

2. How it works

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

• The browser only ever talks to your *.pages.dev site. /api/* requests run a Pages Function that forwards them over a service binding to the agent Worker.
• The agent Worker is deployed with workers_dev: false and preview_urls: false: it has no public URL.
• Authentication and authorization happen in the Worker, not the frontend.
• Chat responses stream as Server-Sent Events end-to-end.

More detail: docs/architecture.md.

3. Cloudflare services used

Talorys does not provision R2, D1, KV, Vectorize, AI Search, Workflows or any paid service.

4. Deploy