Skip to main content
Use uv for project management and install the SDK from the private Backbase Artifactory.

​
1. Configure pyproject.toml

Add the Backbase Artifactory repository to your pyproject.toml. This tells uv where to find the bb-ai-sdk package.
pyproject.toml

​
2. Authenticate with Artifactory

Set your Artifactory username and either a password or an API key as environment variables. Add these variables to your .env file, and make sure .env is in .gitignore:
.env
Connector passwords and API keys are separate from this Artifactory login. For more information, see Credentials.
The environment variable format is UV_INDEX_<NAME>_USERNAME, where <NAME> matches the name you defined in pyproject.toml (uppercased). You must export them in .env file

​
3. Install the SDK

Load your environment variables and add the package:
Install the instrumentation bundles you need. These pull OpenInference + OTel helpers; they do not install Agno/LangChain themselves.
Guardrails: uv add "bb-ai-sdk[guardrails]==0.1.9" --index backbase

​
Verification

Verify the installation was successful (expect 0.1.9):