Create an app and API key

An app is a separate memory space with its own settings and API keys. You create one in the dashboard. When you publish it, the dashboard shows the app ID and the first API key. Copy both then, because the key appears once.

Sign inCopy Anchor Link

1. Open the dashboard at https://smritea.ai/dashboard.
2. Choose Sign in with Google or Sign in with GitHub. You can also use the Create Account tab with your email and a password.
3. If you used email, open the verification message and confirm your address. The dashboard then sends you back to the sign-in page.

Only approved emails can sign up. If your email is not approved, the page shows a Book a call with the Smritea team link.

Create the appCopy Anchor Link

1. Open Applications in the sidebar.
2. Select Create App. The dashboard starts a draft app, so you can leave and resume later.
3. On the Basics step, fill in three fields:
   • App name: required, up to 255 characters.
   • Storage engine: Quick Search or Deep Search. See How Smritea stores memory. You cannot change the engine after the app has memories.
   • Data plane: the region. It looks like us-east-1 (aws). You cannot change it after you create the app. See Regions.
4. Select Save & Continue.
5. On the Ontology step, you can describe your app and set extraction directives. Every field is optional. If you leave the step alone, the default ontology applies. The Configure with AI button needs a description of at least 200 characters.
6. Select Save & Continue.
7. On the Review step, check your choices and select Publish.

Copy your credentialsCopy Anchor Link

After you publish, the Your app is live page shows two values:

The dashboard shows the key once. If you leave the page without copying it, create a new key as described below. The dashboard lists only the first eight characters of a key after that.

Treat the key as a secret. Keep it out of source control and load it from an environment variable.

Use the credentials in codeCopy Anchor Link

Create the client from two environment variables, so the key never appears in your source. The Quickstart shows how to set them.

import os

from smritea import SmriteaClient

client = SmriteaClient(
    api_key=os.environ["SMRITEA_API_KEY"],
    app_id=os.environ["SMRITEA_APP_ID"],
)

If your app is in India, also set the host as described in Regions.

Create or revoke a key laterCopy Anchor Link

1. Open Applications, then open your app.
2. Open the API Keys tab.
3. To create a key, select Create Key, enter a Key Name and confirm. The dashboard shows the new key once.
4. To revoke a key, select the trash icon on its row. A revoked key stops working, and the dashboard does not ask you to confirm.

You cannot rotate a key in place. To replace a key, create a new one, deploy it, then revoke the old one. Each plan limits how many active keys your organization can hold. If you are at the limit, revoke a key first. See Limits, quotas and credits.

Next stepsCopy Anchor Link

• Run your first example in the Quickstart.
• Pick the right host for your region in Regions.