Cognite Python SDK
This is the Cognite Python SDK for developers and data scientists working with Cognite Data Fusion (CDF). The package is tightly integrated with pandas, and helps you work easily and efficiently with data in Cognite Data Fusion (CDF).
What's new in v8
The SDK v8 introduces full async support with the new AsyncCogniteClient. This enables:
- Native
async/awaitpatterns for all API operations - Non-blocking concurrent operations directly in Notebooks (including browser-based via Pyodide) and UI frameworks like Streamlit
- Significantly faster file uploads on Windows (new underlying HTTP client,
httpx)
# Async client (new in v8!)
from cognite.client import AsyncCogniteClient
async def main():
client = AsyncCogniteClient()
tss = await client.time_series.list()
# Sync client (still supported)
from cognite.client import CogniteClient
client = CogniteClient()
tss = client.time_series.list()
The synchronous CogniteClient remains fully supported and now wraps the async client internally.
See the Migration Guide for a complete list of changes.
Reference documentation
Installation
Without any optional dependencies
To install the core version of this package:
pip install cognite-sdk
With optional dependencies
A number of optional dependencies may be specified in order to support a wider set of features. The available extras (along with the libraries they include) are:
- numpy
[numpy] - pandas
[pandas] - geo
[geopandas, shapely] - sympy
[sympy] - yaml
[PyYAML] - all
[numpy, pandas, geopandas, shapely, sympy, PyYAML]
To include optional dependencies:
pip:
pip install "cognite-sdk[pandas, geo]"
poetry:
poetry add cognite-sdk -E pandas -E geo
uv:
uv add "cognite-sdk[pandas, geo]"
Performance notes
If you regularly need to fetch large amounts of datapoints, consider installing with numpy
(or with pandas, as it depends on numpy) for best performance, then use the retrieve_arrays (or retrieve_dataframe) endpoint(s). This avoids building large pure Python data structures, and instead reads data directly into memory-efficient numpy.ndarrays.
Windows specific
If you experience issues installing the geo extra on Windows, consider using conda to install geopandas first. See the geopandas installation page for details.
Changelog
Wondering about upcoming or previous changes to the SDK? Take a look at the CHANGELOG.
Migration Guide
To help you upgrade your code(base) quickly and safely to a newer major version of the SDK, check out our migration guide. It is a more focused guide based on the detailed change log. MIGRATION GUIDE.
Contributing
Want to contribute? Check out CONTRIBUTING.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cognite_sdk-8.12.0.tar.gz.
File metadata
- Download URL: cognite_sdk-8.12.0.tar.gz
- Upload date:
- Size: 750.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.20
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0e9a3fa6d166820680834663e260310d710d482d00f2629f664622770be526ac
|
|
| MD5 |
52a0058dad22cb5072e16f59a1926043
|
|
| BLAKE2b-256 |
ddd6b2c44176b0dc2d350cd4ba7da1fa2c1c5ed08c0b088c388c0abc33b1134f
|
File details
Details for the file cognite_sdk-8.12.0-py3-none-any.whl.
File metadata
- Download URL: cognite_sdk-8.12.0-py3-none-any.whl
- Upload date:
- Size: 990.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.20
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
17a0fccd659780f0b88ba48b39061f106fe29e58ae1fe1b4ec62527b556b6b31
|
|
| MD5 |
ade1c19cb368a7f4ea4eec3b8056be3c
|
|
| BLAKE2b-256 |
d6bd28a8570567334a893198ed9af4ad5b911d7b5e6a8c1978fd0aa80fb0c9ae
|
