Run Your Own Free AI Assistant on Cloudflare: The Talorys Setup
Put Talorys, a free open-source AI assistant, in your own Cloudflare account with one command, then get it remembering you and running your tasks.
Back to all free guidesSo in the reel I showed Talorys, the free, open-source AI assistant that runs in your own Cloudflare account. This is the full setup, step by step, plus the first message I'd send it and how to keep it inside the free daily allowance. It's basically one command, and you don't need to write a line of code.
What it does, in a minute
- It's free and open source. MIT licence, built by Roc Yu, and it had over 900 stars on GitHub by 13 October, three days after it came out. The code is at github.com/rociiu/talorys.
- It lives in your own Cloudflare account. Your chats, memories, tasks and notes are stored there, the AI runs on Cloudflare's Workers AI, and nothing gets sent to the people who built it.
- It remembers you. Facts and preferences go on a Memory page, where you can view, edit and delete them.
- It handles your tasks, notes and projects. Use the pages in the app, or just type it in chat, like "Add a task to review my project tomorrow".
- It does reminders. One-off and recurring ones, plus a daily task digest. They show up inside the app, in its notification centre, rather than as alerts on your phone.
- It works on your phone too. Open your link in your phone's browser, and sign in on as many devices as you like.
Before you start
- Node.js 22 or newer. Grab it from nodejs.org, then type
node -vin your terminal to check the number. - A free Cloudflare account. Make one on Cloudflare's sign-up page. Every account starts on the Workers Free plan, and that's all Talorys needs.
- An owner password. At least 10 characters, mixing letters with numbers or symbols, or a passphrase of 16 or more. It's the one password that gets you in, so pop it in your password manager.
Set it up, step by step
- Open your terminal in a folder you'll remember. The installer makes a
talorysfolder inside it, and you need that folder later for updates. - Run the command below. It checks your Node.js version first and brings its own copy of Cloudflare's tools, so there's nothing else to install.
- Sign in to Cloudflare. If you're not signed in already, it opens Cloudflare's authorisation page in your browser. Approve it, then head back to the terminal.
- Answer its questions. Pick an agent name (it suggests Talorys), say whether you want semantic recall (the default is no, and you can switch it on later under Settings > AI), and choose your Cloudflare account if you've got more than one.
- Set your owner password and confirm the plan. Type the password twice, look over the deployment plan it shows you, then confirm.
- Copy your link. It deploys everything, checks it's live and prints your link, which ends in pages.dev.
- Open the link and sign in with your owner password, and you're in.
npx create-talorys@latestIf it stops halfway, literally just run the same command again in the same place. It picks up where it left off, without making duplicates or deleting anything. A brand new pages.dev link can also take a few minutes to start working, so if the health check fails, wait a bit and run it again.
The first thing to try
Tell it about yourself and give it a job in the same message, so you see memory, tasks and reminders working in one go. Fill in the last four lines:
Remember the three things below about me. Then add the task below for tomorrow, and set a reminder for it at 9am tomorrow.
My work:
How I like my answers:
A goal I'm working towards:
Task:Then open Memory, Tasks and Automations in the sidebar, and you'll see it all landed. It saves up to three memories per message, which is why there are three. If it got anything wrong, just edit it on the Memory page.
- It also learns as you chat. Learn from conversations is on from the start, so it saves lasting preferences without being asked. If you'd rather it only saves when you say remember, switch that off under Settings > AI.
- Reminders use your computer's timezone. The installer picks it up, and you can change it under Settings > General.
Keep it free and keep it running
- You get a daily AI allowance. Cloudflare gives every account 10,000 Neurons of Workers AI a day at no charge (Neurons are how it measures AI use), and it resets at 00:00 UTC. The numbers are on Cloudflare's Workers AI pricing page.
- When it's used up, chat pauses until the reset. That's on the Workers Free plan. Your tasks, notes, memories and reminders keep working, and your data isn't touched. If your account is on Workers Paid, Cloudflare bills anything over the 10,000 at $0.011 per 1,000 Neurons instead.
- Reminders and digests don't use the allowance. Simple reminders and task digests never use AI at all.
- Set your own cap. Under Settings > AI, Max AI requests per day starts at 200 and goes up to 2,000, so if chat says it's hit that limit, this is where you raise it. The Usage panel there shows what you've used today, and for exact Neuron numbers it links through to your Cloudflare dashboard.
- It never turns on paid features by itself. Talorys is built to fit the Workers Free plan.
- Back it up. Settings > Privacy > Download backup saves your chats, memories, tasks, notes, projects, settings and automations in one file, talorys-backup.json.
- Update it. When Settings > About shows a new version, run this from your talorys folder. Your data and password stay as they are.
npx create-talorys@latest updateIf something's not right, npx create-talorys@latest doctor checks everything for you. Forgot your password? npx create-talorys@latest reset-password sets a new one and signs out every device. Run both from the same talorys folder.
To be honest, an assistant that remembers you and runs in your own Cloudflare for free is pretty sweet, so get it set up and tell it a few things about yourself.