> ## Documentation Index
> Fetch the complete documentation index at: /dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart: your app

> Give every user of your own app a memory of their own, with a project key.

**1. Create a project**

In the [Dev Console](https://www.constella.app/console?tab=projects), open **Projects** and press **Create New Project**. Its first key is shown once: copy it to your server now.

```bash theme={"system"}
export CONSTELLA_APP_KEY="cak_live_..."
```

**2. Save for one user**

Put your own id for the user in the address (not an email). The first save makes the user. Your users never need a Constella account.

```bash curl theme={"system"}
curl https://api.constella.app/platform/v1/users/u_123/tools/memory_add \
  -H "Authorization: Bearer $CONSTELLA_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"text": "Prefers short answers.", "id": "pref:length"}}'

# {"result": {"id": "pref:length", "app": "appmyappx7k2", "updated": false}}
```

```python Python theme={"system"}
import os, requests

def tool(uid: str, name: str, **arguments):
    r = requests.post(
        f"https://api.constella.app/platform/v1/users/{uid}/tools/{name}",
        headers={"Authorization": f"Bearer {os.environ['CONSTELLA_APP_KEY']}"},
        json={"arguments": arguments},
    )
    r.raise_for_status()
    return r.json()["result"]

tool("u_123", "memory_add", text="Prefers short answers.", id="pref:length")
```

```javascript JavaScript theme={"system"}
async function tool(uid, name, args) {
  const res = await fetch(`https://api.constella.app/platform/v1/users/${uid}/tools/${name}`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.CONSTELLA_APP_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ arguments: args }),
  });
  if (!res.ok) throw new Error((await res.json()).detail?.message);
  return (await res.json()).result;
}

await tool("u_123", "memory_add", { text: "Prefers short answers.", id: "pref:length" });
```

**3. Recall for that user**

Each user only ever sees their own memory. Two users never mix.

```bash curl theme={"system"}
curl https://api.constella.app/platform/v1/users/u_123/tools/memory_recall \
  -H "Authorization: Bearer $CONSTELLA_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"query": "how does this user like answers?"}}'
```

```python Python theme={"system"}
tool("u_123", "memory_recall", query="how does this user like answers?")
```

```javascript JavaScript theme={"system"}
await tool("u_123", "memory_recall", { query: "how does this user like answers?" });
```

**4. Keep the key on your server**

A project key reaches every one of your users. Never ship it in a phone app or a web page. Your server calls Constella; your app calls your server.

## Next

> [card] [How it works](/dev/docs/build/overview.md)

> [card] [Your app's users](/dev/docs/build/app-users.md)

> [card] [Sync their apps](/dev/docs/build/sync-apps.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.