Devo Python SDK

7.0.0 verified Fri May 01 auth: no python

Official Python SDK for Devo (data analytics and logging platform). Version 7.0.0, released 2026-02-11. Provides client libraries for querying, sending data, and managing lookups. Release cadence is irregular (several minor patches per year).

pip install devo-sdk

Common errors

error ModuleNotFoundError: No module named 'devo_sdk' ↓

cause The package is installed as 'devo-sdk' (with hyphen) but import uses underscore or wrong name.

fix

Install the package and import using correct module name: 'import devo' or 'from devo.api import Client'.

error ImportError: cannot import name 'Client' from 'devo.api' ↓

cause Incorrect import path; the Client class is in devo.api but the package may not be properly installed or you're using outdated version.

fix

Ensure devo-sdk is installed (pip install devo-sdk) and import using 'from devo.api import Client'.

error devo.common.exceptions.DevoClientException: Invalid API credentials ↓

cause API key or secret are missing or incorrect.

fix

Set DEVO_API_KEY and DEVO_API_SECRET environment variables with valid Devo API credentials.

Warnings

breaking Python 3.9 support dropped in v7.0.0. Minimum required Python version is now 3.10. ↓

fix Upgrade to Python 3.10 or higher, or stay on v6.x if you need Python 3.9.

deprecated Lookup upload via my.lookup.data/my.lookup.control tables is deprecated. Use the Lookups API instead. ↓

fix Migrate to the Lookups API endpoint (see Devo docs). The Python SDK will add native support in future versions.

gotcha The import path for Client is 'from devo.api import Client', not 'from devo_sdk.api import Client'. ↓

fix Use 'from devo.api import Client'.

gotcha The Sender class is in devo.common, not devo.sender. Mistaken imports cause ImportError. ↓

fix Import via 'from devo.common import Sender'.

Imports

Client

wrong

from devo_sdk.api import Client

correct

from devo.api import Client

Common incorrect package name 'devo_sdk'

Sender

wrong

from devo.sender import Sender

correct

from devo.common import Sender

Wrong submodule path

LoggerConfig

wrong

from devo.logger import LoggerConfig

correct

from devo.common import LoggerConfig

LoggerConfig is in devo.common, not devo.logger

Quickstart

Initialize a Devo API client and run a simple query. Requires environment variables DEVO_API_KEY, DEVO_API_SECRET, and optionally DEVO_API_URL.

import os
from devo.api import Client

api = Client(
    config={
        "key": os.environ.get("DEVO_API_KEY", ""),
        "secret": os.environ.get("DEVO_API_SECRET", ""),
        "url": os.environ.get("DEVO_API_URL", "https://api-us.devo.com/search/query"),
    }
)
query = "from demo.ecommerce.data select * limit 10"
print(api.query(query=query))