SDK

Why Use the SDK?

In general, we recommend using the SDK. It simplifies interaction with the Elements Platform API by:

• Reducing complexity - Native Python interface instead of gRPC protocol buffers
• Fewer dependencies - Minimal package requirements
• Better developer experience - Pythonic methods and clear error handling
• Complete access - Full platform functionality available programmatically

Below is an example of calling Elements using the API versus the SDK:

API:

from elements_api.sync_client import ElementsSyncClient
from elements_api.models.aoi_collection_pb2 import AOICollectionCreateRequest

client = ElementsSyncClient()
request = AOICollectionCreateRequest(name="My AOI Collection")
await client.api.aoi_collection.create(request)

SDK:

from elements.sdk.elements_sdk import ElementsSDK

sdk = ElementsSDK()
await sdk.aoi_collection.create(name="My AOI Collection")

SDK Installation

pip install privateer-elements-sdk

The SDK automatically installs the required API client (elements-api).