Add Aether to a Lovable app

Wire Aether memory and retrieval into a full-stack app you're building with Lovable.

Aether is a managed memory and retrieval API: store text or documents, then recall the most relevant pieces by meaning. In a Lovable app, reach for it when you need persistent per-user memory (preferences, history that should survive across sessions) or RAG over content your users upload — anything beyond what Lovable's database stores as plain rows.

Prompt Lovable with this

Paste the block below into the Lovable chat when you ask for a memory or search feature. Lovable generates a backend for you, so it can call Aether server-side directly. Add your key first under Project Settings → Secrets as AETHER_API_KEY.

Use Aether for persistent memory and document retrieval in this app.

Setup:
1. Install the SDK: `npm install @aether-ai/sdk` (for a Python backend: `pip install aether-ai`).
2. Read the API key from the `AETHER_API_KEY` environment variable. Never hardcode it and never expose it to the browser — all Aether calls run server-side.

Per-user memory (TypeScript):
  import { Memory } from "@aether-ai/sdk";
  const memory = new Memory(userId, { apiKey: process.env.AETHER_API_KEY });
  await memory.remember("a fact about this user"); // store one memory
  const hits = await memory.recall("a question", { k: 5 }); // returns [{ text, score }], higher score = more relevant

Document search / RAG (TypeScript):
  import { AetherClient } from "@aether-ai/sdk";
  const client = new AetherClient({ apiKey: process.env.AETHER_API_KEY });
  await client.insertText("some document text"); // store a document
  const results = await client.retrieve("a question", 5); // passages with .content, ready for a prompt

Rules:
- Scope memory per user: pass a stable user id as the entity id.
- Call Aether from a server route, action, or API handler — never from client components.
- Use Memory for personalization; use AetherClient + retrieve for RAG over documents.

If the agent didn't get it right

Three manual steps recover any integration:

1. Install the SDK — add @aether-ai/sdk from Lovable's dependency panel, or npm install @aether-ai/sdk if you've connected the project to GitHub and are editing locally.
2. Set the key — add AETHER_API_KEY under Project Settings → Secrets so it's available to the backend. Get a key from the Aether Dashboard.
3. Call from a backend function — put new Memory(userId, { apiKey: process.env.AETHER_API_KEY }) inside a server function or edge function and expose remember / recall to the frontend through it. Never use the key in client code.

Good first builds

• A personalized app — remember each signed-in user's preferences and choices, then recall them to tailor what the app shows.
• A knowledge-base chatbot — insertText the docs your users upload, then retrieve relevant passages to answer their questions.

New to the SDK? Walk through the TypeScript quickstart first.