Registry / devops / cognite-toolkit

cognite-toolkit

library0.8.111pypypiunverified

Official Cognite Data Fusion tool for managing project templates and configuration deployment. Current version 0.8.62, actively maintained and released weekly.

devops data

pip install cognite-toolkit

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · COGNITE-TOOLKIT

cognite-toolkit

devopspythonv0.8.111

Install

18.4s avg

Import

—

Disk

272MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.8.111 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

py 3.11

✓ —

✓ 17.2s

py 3.12

✕ build_error

py 3.13

✓ —

✓ 15.1s

py 3.9

✕ build_error

✓ 22.8s

272MB installed

● package 272MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ToolkitClient

✓ from cognite_toolkit import ToolkitClient

✗ from cognite_toolkit import ToolkitClient

Initialize a ToolkitClient and check the connection status.

from cognite_toolkit import ToolkitClient import os client = ToolkitClient( base_url=os.environ.get('CDF_BASE_URL', 'https://api.cognitedata.com'), project=os.environ.get('CDF_PROJECT', 'my-project'), api_key=os.environ.get('CDF_API_KEY', '') ) print(client.status())

cognite --version

Debug

Known issues

breakingThe old top-level import `import cognite_toolkit` does not expose `ToolkitClient`. You must use `from cognite_toolkit import ToolkitClient` from version 0.7.0 onward.

fix

Use `from cognite_toolkit import ToolkitClient` instead of `import cognite_toolkit`.

affects: >=0.7.0

deprecatedThe argument `default_env` in `cdf.toml` is deprecated; use `default_config_yaml` instead.

fix

Replace `default_env` with `default_config_yaml` in your `cdf.toml`.

affects: >=0.8.61

gotchaUsing `--credentials` on the command line with an explicit `CLIENT_ID` and `CLIENT_SECRET` may expose secrets in shell history. Prefer environment variables `CDF_CLIENT_ID`, `CDF_CLIENT_SECRET`.

fix

Set `CDF_CLIENT_ID` and `CDF_CLIENT_SECRET` environment variables instead of passing them as flags.

affects: all

gotchaWhen deploying RAW databases, a misconfigured `Database.yaml` or `Table.yaml` with unsupported fields will cause the entire file to be skipped silently (since 0.8.58). No error message is shown.

fix

Validate your YAML files against the expected schema before deployment.

affects: >=0.8.58

Upgrade

Version history

0.8.111latest on PyPI · released Jun 17, 2026

Audit

Dependencies

cognite-sdkrequiredCore SDK for Cognite Data Fusion API

pyyamlrequiredYAML parsing for configuration files

richrequiredTerminal output formatting

requestsrequiredHTTP requests for API calls

Agent activity

9 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/cognitedata/toolkit ↗

packagehttps://pypi.org/project/cognite-toolkit/ ↗

homepagehttps://docs.cognite.com/cdf/deploy/cdf_toolkit/ ↗

docshttps://docs.cognite.com/cdf/deploy/cdf_toolkit/references/resource_library ↗

changeloghttps://github.com/cognitedata/toolkit/releases ↗