Quickstart

Create and deploy your first data product in 5 minutes.

Note

This guide assumes you have akili CLI installed and configured with API credentials.

1. Create a tenant (admin only)

   akili tenant create my-org --display-name "My Organization"

2. Initialize a data product

   mkdir my-product && cd my-product
   akili init --name my-product

   This creates 6 YAML manifest files in .akili/:

   • product.yaml — Product identity, classification, and domain
   • inputs.yaml — Upstream product or connector resource declarations
   • output.yaml — Output schema contract (columns, types, roles)
   • quality.yaml — Quality checks and SLA definitions
   • serving.yaml — Serving intent and materialization
   • compute.yaml — Runtime, engine, schedule, resources

3. Validate manifests

   akili validate .akili/

4. Deploy the data product

   akili product deploy my-product

   Use --dry-run to preview changes before applying, or --version v2 for a specific version.

5. Trigger an execution

   akili run trigger my-product

   Add --force to re-execute even if data is up to date.

6. Query the results

   cURL

   curl -H "Authorization: Bearer $TOKEN" \
     "https://api.akili.systems/api/v1/products/my-product/data?tenant=my-org"

   Python

   import httpx
   
   resp = httpx.get(
       "https://api.akili.systems/api/v1/products/my-product/data",
       params={"tenant": "my-org"},
       headers={"Authorization": f"Bearer {token}"},
   )
   data = resp.json()["data"]

   TypeScript

   const resp = await fetch(
     "https://api.akili.systems/api/v1/products/my-product/data?tenant=my-org",
     { headers: { Authorization: `Bearer ${token}` } },
   );
   const { data } = await resp.json();