GitHub Gems

Talorys: Open-Source Personal AI Agent Runs in Your Cloudflare Account

Talorys is a free, open-source personal AI assistant that runs inside your own Cloudflare account, with chat, memory, tasks and reminders deployed by a single command.

Laptop screen showing a chat interface for a personal AI assistant with task and reminder panels
Photo: GitHub

A new open-source project called Talorys offers a personal AI assistant that runs entirely inside the user's own Cloudflare account. According to its GitHub repository, the tool chats with its owner, remembers important details, manages tasks, notes and projects, and sends scheduled reminders, all without a server, database or account operated by the project's developers. The software is free to use and can be installed with a single command, npx create-talorys@latest, which the repository describes as friendly to Cloudflare's free tier.

What Talorys offers

Talorys is designed for one person. The owner signs in with a password set during installation, and there are no sign-up forms, shared accounts or team features. Chat responses stream in real time and can include Markdown formatting and indicators showing when the assistant is using a tool.

The assistant keeps durable personal facts and preferences, which the owner can view, edit or delete. On each turn, only the memories judged most relevant are sent to the underlying model. An optional semantic recall feature can find memories by meaning rather than exact keywords. It is off by default and has to be enabled in the settings or selected during installation.

Tasks, notes and projects can be managed through the web interface or directly from chat. A user can type a request such as adding a task to review a project tomorrow, and the assistant carries it out. Reminders, daily task digests and optional AI-driven routines appear in an in-app notification center.

Useful even without AI

One notable design choice is that core features do not depend on AI. According to the repository, tasks, notes, memories and reminders keep working if Cloudflare's Workers AI service is unavailable or the free allocation has been used up.

How the system is built

The browser communicates only with a Cloudflare Pages site. Requests under the API path are handled by a Pages Function, which forwards them to a private agent Worker. The repository states that this Worker has no public URL, and that authentication and authorization are handled inside the Worker rather than in the frontend. Chat responses are streamed to the browser using Server-Sent Events.

Scheduled reminders run on Durable Object alarms, a Cloudflare mechanism that lets work happen on a timer without keeping a process running continuously. All of the user's data is stored in a single SQLite-backed Durable Object within the owner's account.

What the installer does

The installer checks for Node.js version 22 or later and uses its bundled Wrangler command-line tool. It verifies the Cloudflare login, or opens Cloudflare's authorization page in a browser, and asks the user to choose an account and name the agent. The owner password is hashed locally using PBKDF2-SHA256 and stored only as a Cloudflare secret.

The installer then deploys the private Worker, creates the Pages project, and checks that the live deployment responds correctly, without running any AI inference. It prints the real web address assigned by Cloudflare. A local configuration file records resource names and the URL, but no secrets. If the process is interrupted, running the same command again reconciles existing resources rather than creating duplicates, and the repository says no data is deleted in that process.

Costs and limits

The project says it is built to fit within Cloudflare's Workers Free plan and does not enable paid features on its own. However, the repository is clear that it is not unlimited. Free accounts have quotas for requests, Durable Object usage and a daily allocation of Workers AI usage. When the AI allocation runs out, chat pauses until the daily reset, while other features continue to work. Users on paid plans are billed by Cloudflare for usage beyond included amounts. The settings also include guardrails such as limits on output length, daily AI requests and scheduled AI runs.

Privacy and data control

According to the repository, Talorys contains no telemetry, analytics, tracking or advertising code and sends no information to its developers. Privacy still depends on Cloudflare, which processes chat messages and relevant memories to run AI inference. The repository advises users to review Cloudflare's privacy policy and the terms for Workers AI.

Users can download a backup file containing conversations, memories, tasks, notes, projects, settings and automations. The backup excludes sessions and credentials. Importing the file merges the data, and repeating the same import does no harm. Updates redeploy the latest code to the same resources, and the repository says the owner password and sessions are kept.

What comes next

Talorys is a young project maintained by its creator, Roc Yu, with contributions credited in the repository to developers including Derek and Rudy Celekli. Its appeal lies in giving individuals a personal assistant they can host and control within a platform they already use, at little or no cost for light use. Readers considering it should weigh the convenience of a one-command setup against the need to understand Cloudflare's quotas and data-handling terms. For people who want a private, self-hosted assistant, Talorys represents a clear example of how the approach is developing.

Source: GitHub

Comments (0)