Skip to main content

Dateno Python SDK — Installation & Setup

Overview​

This guide explains how to install, configure, and authenticate the Dateno Python SDK. It is intended for developers who want to integrate with the Dateno API using Python.

The SDK is type-safe, based on Pydantic models, and supports both synchronous and asynchronous usage.

⚠️ Early Access
The SDK is available to users as an early access tool for integrating with the Dateno API.
While it is production-ready for most common use cases, the public API and SDK may still evolve.
We strongly recommend pinning the SDK version in production environments.

Requirements​

  • Python 3.9+
  • pip
  • A valid Dateno API key

Installation​

pip install "git+https://github.com/datenoio/dateno-sdk-python.git@main"

For stable production usage, pin the SDK to a specific commit:

pip install "git+https://github.com/datenoio/dateno-sdk-python.git@<COMMIT_SHA>"

Local installation (for development)​

This option is useful if you want to modify the SDK, run examples locally, or contribute to the repository.

1) Clone the repository​

git clone https://github.com/datenoio/dateno-sdk-python.git
cd dateno-sdk-python

2) Create a virtual environment​

python -m venv .venv

3) Activate the virtual environment (by OS / shell)​

macOS / Linux​

bash / zsh

source .venv/bin/activate

fish

source .venv/bin/activate.fish
Windows​

PowerShell

.\.venv\Scripts\Activate.ps1

Command Prompt (cmd.exe)

.\.venv\Scripts\activate.bat

Git Bash

source .venv/Scripts/activate

Note (Windows PowerShell): if script execution is blocked, enable it for the current user:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

4) Install the SDK in editable mode​

pip install -e .

5) Quick sanity check (optional)​

python -c "import dateno; print('Dateno SDK imported successfully')"

Authentication​

The SDK uses API key authentication.

The API key is passed as a query parameter:

from dateno import SDK

sdk = SDK(api_key_query="YOUR_API_KEY")

You can also provide it via environment variables if needed:

export DATENO_APIKEY=YOUR_API_KEY
SDK(api_key_query=os.environ["DATENO_APIKEY"])

Configuring the Server URL​

By default, the SDK uses the production API endpoint.

You can override it if needed (for example, for testing):

SDK(
    api_key_query="YOUR_API_KEY",
    server_url="https://api.test.dateno.io",
)

Verifying Installation​

You can verify that everything works by calling the health check endpoint:

from dateno import SDK

with SDK(api_key_query="YOUR_API_KEY") as sdk:
    print(sdk.service.get_healthz())

If the SDK is configured correctly, the call should return a successful response.

Next Steps​