paradime-io

library5.7.0pypypi✓ verified 89d ago

The `paradime-io` library provides the official Python SDK and CLI for interacting with the Paradime platform. Paradime positions itself as an 'operating system for analytics,' designed to streamline analytics engineering workflows by unifying data exploration, dbt™ model building, scheduling, and data lineage in a single environment. It enables users to code, run, and manage data pipelines for analytics and AI. The library is actively maintained, with a current version of 5.1.0, and a regular release cadence based on its extensive release history.

data devops workflow aws gcp

pip install paradime-io

package ↗homepage ↗

INSTALL

IMPORT

SIG · PARADIME-IO

paradime-io

datapythonv5.7.0

Install

13.5s avg

Import

1153ms

Disk

259MB

Pass rate

7/ 10

Env Coverage7 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v4.18.0 · 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

✓ —

✓ 7.5s

py 3.11

✕ build_error

✓ 19.3s

py 3.12

✕ build_error

✓ 16.38s

py 3.13

✕ build_error

✓ 16s

py 3.9

✓ —

✓ 8.55s

259MB installed

● package 259MB

Code

Verified usage

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

Paradime

✓ from paradime import Paradime

The main client class for interacting with the Paradime API.

Initialize the Paradime client using API credentials. It is highly recommended to store `PARADIME_API_ENDPOINT`, `PARADIME_API_KEY`, and `PARADIME_API_SECRET` as environment variables. These can be generated within your Paradime workspace settings.

import os from paradime import Paradime # Retrieve API credentials from environment variables for security api_endpoint = os.environ.get("PARADIME_API_ENDPOINT", "https://api.paradime.io") # Default API endpoint api_key = os.environ.get("PARADIME_API_KEY", "") api_secret = os.environ.get("PARADIME_API_SECRET", "") if not api_key or not api_secret: print("Warning: PARADIME_API_KEY or PARADIME_API_SECRET not set as environment variables.") print("Please generate your API key, secret, and endpoint from Paradime workspace settings.") print("Falling back to placeholder values. This will likely result in authentication errors.") paradime = Paradime( api_endpoint=api_endpoint, api_key=api_key, api_secret=api_secret, ) # Example: List available dbt jobs (requires appropriate permissions) # try: # jobs = paradime.dbt_jobs.list_jobs() # print(f"Found {len(jobs.data)} dbt jobs.") # for job in jobs.data: # print(f" - Job ID: {job.id}, Name: {job.name}") # except Exception as e: # print(f"Error interacting with Paradime API: {e}")

paradime --version

Debug

Known issues

gotchaAPI Key and Secret must be obtained from your Paradime workspace settings. Hardcoding them directly in your codebase is discouraged for security reasons.

fix

Generate `api_key`, `api_secret`, and `api_endpoint` from your Paradime workspace settings. Use environment variables to store them securely: `export PARADIME_API_ENDPOINT="YOUR_API_ENDPOINT"`, `export PARADIME_API_KEY="YOUR_API_KEY"`, `export PARADIME_API_SECRET="YOUR_API_SECRET"`.

affects: All versions

gotchaWhen running Python scripts within Paradime's Bolt scheduler using Poetry for dependency management, `poetry install` must be the first command in your schedule.

fix

Ensure your Bolt schedule configuration includes `poetry install` as the initial step to set up the execution environment correctly.

affects: All versions supporting Python scripts in Bolt

gotchaThe Paradime client currently targets Python >=3.11. Using older Python versions will lead to installation or runtime errors.

fix

Ensure your environment is running Python 3.11 or newer. Upgrade your Python installation if necessary.

affects: <5.0.0 (based on PyPI 'requires_python' changing)

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'paradime'

The `paradime-io` package is not installed in the current Python environment, or the environment is not activated.

fix

Run `pip install paradime-io` to install the package. If using a virtual environment, ensure it is activated before running your script.

paradime.exceptions.AuthenticationError: Invalid API credentials provided

The `api_endpoint`, `api_key`, or `api_secret` provided to the `Paradime` client are incorrect, expired, or missing, preventing successful authentication with the Paradime API.

fix

Double-check your API credentials in your Paradime workspace settings. Ensure they are correctly passed to the `Paradime` constructor, or that the `PARADIME_API_ENDPOINT`, `PARADIME_API_KEY`, and `PARADIME_API_SECRET` environment variables are correctly set and accessible to your application.

Upgrade

Version history

5.7.0latest on PyPI · released May 28, 2026

Audit

Dependencies

pythonrequiredRequired Python version

Agent activity

22 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/paradime-io/ ↗

homepagehttps://paradime.io ↗