The Dodil SDK

lets you talk to Dodil services from your application (starting with Python, with more languages coming later).

Install

If you already use Python in a virtual environment (recommended), install the SDK with pip:


pip install -U dodil

If you don’t have a virtual environment yet:


python -m venv .venv
source .venv/bin/activate
pip install -U dodil

You can always find the latest published version on PyPI:

https://pypi.org/project/dodil/

Verify the installation

Run a quick import check:


python -c "import dodil; print('dodil:', getattr(dodil, '__version__', 'installed'))"

If that prints a version (or installed), you’re good.

Authentication (required)

Most Dodil APIs require authentication. The recommended way is to use an IAM Service Account (client credentials) so your app can securely access Dodil services.

What you’ll need

A Service Account created in IAM
The Client ID and Client Secret for that Service Account

Next step:

➡️ Go to IAM → Service Accounts and create one:

IAM Service Accounts

That page explains:

how to create a Service Account
how to retrieve credentials
how to scope permissions for least-privilege access

SDK reference and examples

Once you have credentials, follow the SDK reference for configuration and usage examples:

SDK reference repo (examples + setup): https://github.com/dodilio/sdk-dodil-python

You’ll find:

configuration patterns (local dev vs production)
how to pass credentials safely (env vars / secret managers)
practical examples for each service module