rociiu / talorys

# Talorys
**Your personal AI agent. Your own cloud.**
Website: rociiu.github.io/talorys
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.
 [code] 
Or install it with Appflare, which deploys it as a
single Worker:
---
## 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, lists them newest first with their saved date, and lets the agent find tasks, notes and automations by meaning. 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, Talorys asks you whether the old one is now a past fact, and with the optional AI check a confident answer does it for you. Unclear conflicts also 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"). Chat task due dates reject impossible calendar dates, including timestamps with explicit UTC offsets.
- **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.
- **Push notifications** — reminders, digests and routines also arrive as system notifications on the phones and computers you turn them on for, even when Talorys is closed (Settings → General). Uses standard Web Push, encrypted end to end; on iPhone and iPad, add Talorys to the Home Screen first.
- **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
 [code] 
- 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 Ser