Install ADA | Agile Data Engine

Private Preview

Installation can be activated per tenant basis. Contact ADE support, reach out in Community Slack or through the contact form in case you’re interested in activating Agile Data Agent.

Before installing, make sure you have:

A tenant with Agile Data Agent activated (see Private Preview above)

An External API key (key ID + secret), created in Admin UI.
- See Setting up API-keys for ADA for the required permissions.
Your IP address allowlisted for the tenant, see Network restrictions below.

Installation

Agile Data Agent is installed through the ADE Artifacts store.

MacOS/Linux (Bash)

Bash

curl -fsSL https://artifacts.saas.agiledataengine.com/install.sh | bash

Windows (PowerShell)

PowerShell

irm https://artifacts.saas.agiledataengine.com/install.ps1 | iex

By default, ADA is installed into a Python virtual environment. If the environment isn't already active, the installer will prompt you to activate it.

The installer authenticates using your External API key.

See the below instructions for installation variables e.g. how to install a specific version of ADA.

Using installation variables

Install a Specific Version

By default the installer installs the latest stable release. To install a specific version, set the VERSION environment variable before running the installer.

MacOS/Linux (Bash)

Bash

curl -fsSL https://artifacts.saas.agiledataengine.com/install.sh | VERSION=X.Y.Z bash

Windows (PowerShell)

PowerShell

$env:VERSION = "X.Y.Z"
irm https://artifacts.saas.agiledataengine.com/install.ps1 | iex

Use an exact release version, for example 0.6.0. Version ranges are not supported.
To change the version of an existing installation, run the installer again with a different VERSION.
Check the installed version with ada --version.

After installing, sync the project's skills and agents to the installed version:

PowerShell

ada upgrade --no-self-update

Network restrictions

Two independent checks must pass before the installer can authenticate:

Tenant-level IP allowlisting. Your IP must be allowed in the Admin UI Access Rules for the tenant.

Both must independently allow your IP. If either blocks it, the installation fails.

If installation fails with an authentication error rather than a network error, double-check that your API key has the correct GET permission (/me), see Setting up API-keys for ADA .