wusaki0723/Aelios

A long memory for your AI. Switch windows, switch clients, switch models — the memory follows you.
English | 简体中文 · QQ group: 1091783659
Aelios is a memory gateway that runs on Cloudflare. Your Chatbox / Claude Code / Codex connects to Aelios first; Aelios forwards the request to the model. Every conversation is kept, and the relevant parts come back automatically next time.
text
your client → Aelios (identify, remember, recall) → the model
## Let an AI set it up
With an AI that can run commands (Claude Code, Codex and the like), send it this:
text
Install and set up Aelios (my AI memory gateway) for me. Read https://raw.githubusercontent.com/wusaki0723/Aelios/main/docs/setup-with-ai.md first and follow it. When I need to click something in the browser or enter a key myself, stop and tell me where.
It works from scratch: it forks and deploys Aelios, creates the Cloudflare token, configures the assistant and imports your old memories. At the end it hands you a base URL, an API key and the model name to pick, ready for your chat app. You need a Cloudflare account (the free plan is enough) and a key for your model. All you do yourself is click "Allow" in the browser (twice for a new install) and store the model key in the Cloudflare dashboard (it tells you where). The guide is written in Chinese; the AI will talk to you in your language.
The recommended setup is API mode plus the MCP connector: chats go through Aelios, so every turn is remembered and recalled automatically, and with MCP the assistant can also look things up and save them on its own. Only if you have a Claude subscription and no API access, use MCP alone.
To do it by hand, follow the three steps below.
## Quick start — three steps
### 1. Deploy
Fork this repo first, then deploy your fork. That way every later update is one click (see Updating).
1. Click Fork at the top of this page.
2. In the Cloudflare dashboard, go to Workers & Pages → Create → Import a repository, connect GitHub and pick your fork. Keep the project name companion-memory-proxy, set the build command to npm ci and the deploy command to npm run deploy. The deploy command creates the D1 database, the Vectorize index and the queue for you.
3. Once it's deployed, open the Worker's Settings → Variables and Secrets and add the secret CHATBOXAPIKEY: make up a password, e.g. sk-my-aelios. It's the only one you need; the optional ones are in SECRETS.md.
You'll get an address like:
text
https://companion-memory-proxy. .workers.dev
Don't run a bare wrangler deploy — it won't create the databases.
Not recommended: the one-click button.
It works, but Cloudflare copies this repo into a new repository in your account instead of forking it. GitHub has no Sync fork for a copy, so every update has to be pulled in by hand. If you use it anyway: the only required field is CHATBOXAPIKEY; for the Vectorize index use Dimensions 1024, Metric cosine; build command npm ci, deploy command npm run deploy. Already deployed this way? See Deployed with the button.
### 2. Add an assistant
Open:
text
https:// /admin
Enter your Worker address and the key from step 1, then go to Settings.
1. Upstream: your Cloudflare account ID (32 characters). For full chat forwarding, also add a CLOUDFLAREAPITOKEN Worker secret.