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
Metadata
2 maintainers
Release files for cognite-sdk 8.18.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cognite_sdk-8.18.0.tar.gz | 779.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cognite_sdk-8.18.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.8 MB
Release files / cognite_sdk-8.18.0.tar.gz
| Download URL | cognite_sdk-8.18.0.tar.gz |
|---|---|
| Size | 779.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
80b9126817fb814a1899f54feb4a6c928fa46f40dd2217a6b6b4177cb2aae78b
|
|
BLAKE2b-256 checksum How to use checksums |
1130fe183dbc6128429c6ba5b614bb49739bc0f9046b18e05d69f05cea286915
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|
Release files / cognite_sdk-8.18.0-py3-none-any.whl
| Download URL | cognite_sdk-8.18.0-py3-none-any.whl |
|---|---|
| Size | 1.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
63360eb3da78f0be146bb9e62c695333ed33c477f68f6738dce615568a4d96b5
|
|
BLAKE2b-256 checksum How to use checksums |
d923b3e3ac7e816abf8ba79e58a946d69b210edb9daeed4508c57c56e32e3654
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|
