Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.emergence.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
SDKs & Client Libraries

CRAFT provides auto-generated SDKs for Python and TypeScript, built from OpenAPI specifications on every release.

Python SDK

Type-safe Python client with async support, Pydantic models, and full API coverage.

TypeScript SDK

Fully typed TypeScript client for Node.js and browser environments.

​
Available SDKs

PackagePython (PyPI)TypeScript (npm)API
Governanceem-runtime-governance-sdk@emergence-ai/em-runtime-governance-sdkOrganizations, Projects, Permissions
Assetsem-runtime-assets-sdk@emergence-ai/em-runtime-assets-sdkData Connections, Artifacts, Files, Models
Utilsem-runtime-utils-sdk@emergence-ai/em-runtime-utils-sdkData Catalog, Scheduling, Context Packs, Memories

​
SDK Generation Pipeline

SDKs are auto-generated from OpenAPI specs using openapi-python-client and the OpenAPI Generator for TypeScript. The pipeline runs on every final release:
1

Extract OpenAPI specs

FastAPI apps export their schemas via app.openapi() at build time.
2

Generate client code

OpenAPI specs are fed to code generators producing typed clients with models, API classes, and authentication helpers.
3

Publish packages

Python SDKs publish to Google Artifact Registry. TypeScript SDKs publish to the @emergence-ai npm scope.
4

Version sync

SDK versions match the platform release version (e.g., platform v4.8.6 → SDK v4.8.6).
SDK versions may lag behind the latest platform service versions. For example, the Runtime UI may use Assets SDK v4.8.11 while the Assets service is at v4.10.1. SDKs are backward-compatible, newer service versions serve older SDK clients without issue. Check the release notes for current versions.

​
Authentication

All SDKs use JWT bearer token authentication via Keycloak: 
from em_runtime_governance_sdk import AuthenticatedClient

client = AuthenticatedClient(
    base_url="https://your-instance.emergence.ai",
    token="your-jwt-token"
)

​
Registry Configuration

SDKs are hosted on Google Artifact Registry (private). Configure your package manager: 
# Add the Artifact Registry index
uv add em-runtime-governance-sdk --index-url https://us-central1-python.pkg.dev/aip-artifacts-store/aipy/simple/

# Or with pip
pip install em-runtime-governance-sdk \
  --index-url https://us-central1-python.pkg.dev/aip-artifacts-store/aipy/simple/
Registry authentication requires Google Cloud credentials. See your platform admin for access tokens or Workload Identity setup.

​
Next Steps

Python SDK Guide

Installation, usage patterns, error handling

TypeScript SDK Guide

Setup, type safety, async patterns

API Reference

Interactive API playground with all endpoints

Authentication

Keycloak OIDC setup and token management