Skip to content
Switch branches/tags
Go to file

Latest commit

* More lenient label input

* fix

* fix2

* fixes

* add test and update version and changelog

* CONTEXT-1425 flatten metadata in em fit etc (#787)

* flatten metaata

* version

* version

* review

* ninja

* ninja fail

Co-authored-by: Sander Land <>

Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Cognite logo

Cognite Python SDK

build codecov Documentation Status PyPI version tox Code style: black

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).



In order to start using the Python SDK, you need

  • Python3 (>= 3.5) and pip
  • An API key. Never include the API key directly in the code or upload the key to github. Instead, set the API key as an environment variable. See the usage example for how to authenticate with the API key.

This is how you set the API key as an environment variable on Mac OS and Linux:

$ export COGNITE_API_KEY=<your API key>

On Windows, you can follows these instructions to set the API key as an environment variable.


To install this package:

$ pip install cognite-sdk

To install this package without the pandas and NumPy support:

$ pip install cognite-sdk-core


For a collection of scripts and Jupyter Notebooks that explain how to perform various tasks in Cognite Data Fusion (CDF) using Python, see the GitHub repository here


Wondering about upcoming or previous changes to the SDK? Take a look at the CHANGELOG.


Want to contribute? Check out CONTRIBUTING.