---
id: definite-sdk
version: "0.1.20"
license: MIT
license_treatment: permissive
maintenance: active
---

# definite-sdk — Definite SDK for Python

License: permissive · Maintenance: active · Downloads: 119.4K/mo

## What it is and what it does

Definite SDK is a Python client library for interacting with the Definite platform's API. It abstracts away HTTP details and provides a high-level interface to multiple Definite services: a key-value store with version control and transactional commits, SQL query execution against connected database integrations, secrets storage, messaging (currently Slack), and dlt pipeline orchestration with automatic state persistence. The package depends only on requests and is designed to work both as a standalone client and as part of Definite's hosted runtime environment.

Typical usage involves instantiating a DefiniteClient with an API key, then calling methods to access individual services (kv_store, sql_client, secret_store, message_client, integration_store). The key-value store and dlt integration support state management, making it useful for incremental data pipelines and workflow orchestration. The package also provides DuckLake and DuckDB integration helpers for analytics workloads.

Use it for:

- Store and retrieve application state or configuration in a persistent key-value store accessible across Definite-hosted scripts.
- Execute SQL queries against multiple connected database integrations from Python without managing individual database drivers.
- Manage secrets securely and retrieve them in applications running on the Definite platform.
- Send notifications to Slack channels programmatically with rich formatting and threading support.
- Run dlt data pipelines with automatic cursor and state persistence for incremental data loads.
- Attach DuckLake data to DuckDB for analytics queries without manual schema setup.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client for the Definite API that provides key-value storage, SQL query execution, secrets management, messaging, and dlt pipeline integration with state persistence.

Yes, if you are building on the Definite platform or integrating with its API. The package is actively maintained, has low install friction, carries a permissive MIT license, and provides a clean abstraction over multiple Definite services. Install it as a dependency for any Definite-hosted Python application or as a client for external systems that need to interact with Definite's data and messaging APIs. No security vulnerabilities are known.

## Install

pip install definite-sdk
uv add definite-sdk
poetry add definite-sdk

## Installing definite-sdk

Before you install: Low install friction with a single runtime dependency (requests). Active maintenance status with recent releases.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the license notice.

Quickstart:

pip install definite-sdk

from definite_sdk import DefiniteClient

client = DefiniteClient("YOUR_API_KEY")
store = client.kv_store('test_store')
store['key1'] = 'value1'
store.commit()

Requires a valid Definite API key; can be provided as an argument or via DEFINITE_API_KEY or DEF_API_KEY environment variables.

Verify before relying:

- Whether the package supports Python 3.14 in practice (listed in classifiers but version is pre-release).
- Performance characteristics and rate limits for SQL query execution and messaging operations.
- Specific error handling behavior beyond requests.HTTPError for network or authentication failures.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 119.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

definite api client python, key-value store with state persistence, sql query execution client, secrets management sdk, dlt pipeline integration, data integration platform client, slack messaging integration, api-client, data-integration, state-persistence

[View on SkillFed](https://skillfed.io/packages/definite-sdk) · [View on PyPI](https://pypi.org/project/definite-sdk/)