{"id":7489,"library":"paradime-io","title":"Paradime - Python SDK","description":"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.","status":"active","version":"5.1.0","language":"en","source_language":"en","source_url":"https://github.com/paradime-io/paradime-python-sdk","tags":["data-engineering","analytics-engineering","dbt","data-pipeline","cli","sdk","etl"],"install":[{"cmd":"pip install paradime-io","lang":"bash","label":"Install with pip"}],"dependencies":[{"reason":"Required Python version","package":"python","optional":false}],"imports":[{"note":"The main client class for interacting with the Paradime API.","symbol":"Paradime","correct":"from paradime import Paradime"}],"quickstart":{"code":"import os\nfrom paradime import Paradime\n\n# Retrieve API credentials from environment variables for security\napi_endpoint = os.environ.get(\"PARADIME_API_ENDPOINT\", \"https://api.paradime.io\") # Default API endpoint\napi_key = os.environ.get(\"PARADIME_API_KEY\", \"\")\napi_secret = os.environ.get(\"PARADIME_API_SECRET\", \"\")\n\nif not api_key or not api_secret:\n    print(\"Warning: PARADIME_API_KEY or PARADIME_API_SECRET not set as environment variables.\")\n    print(\"Please generate your API key, secret, and endpoint from Paradime workspace settings.\")\n    print(\"Falling back to placeholder values. This will likely result in authentication errors.\")\n\nparadime = Paradime(\n    api_endpoint=api_endpoint,\n    api_key=api_key,\n    api_secret=api_secret,\n)\n\n# Example: List available dbt jobs (requires appropriate permissions)\n# try:\n#     jobs = paradime.dbt_jobs.list_jobs()\n#     print(f\"Found {len(jobs.data)} dbt jobs.\")\n#     for job in jobs.data:\n#         print(f\"  - Job ID: {job.id}, Name: {job.name}\")\n# except Exception as e:\n#     print(f\"Error interacting with Paradime API: {e}\")","lang":"python","description":"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."},"warnings":[{"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\"`.","message":"API Key and Secret must be obtained from your Paradime workspace settings. Hardcoding them directly in your codebase is discouraged for security reasons.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Ensure your Bolt schedule configuration includes `poetry install` as the initial step to set up the execution environment correctly.","message":"When running Python scripts within Paradime's Bolt scheduler using Poetry for dependency management, `poetry install` must be the first command in your schedule.","severity":"gotcha","affected_versions":"All versions supporting Python scripts in Bolt"},{"fix":"Ensure your environment is running Python 3.11 or newer. Upgrade your Python installation if necessary.","message":"The Paradime client currently targets Python >=3.11. Using older Python versions will lead to installation or runtime errors.","severity":"gotcha","affected_versions":"<5.0.0 (based on PyPI 'requires_python' changing)"}],"env_vars":null,"last_verified":"2026-04-16T00:00:00.000Z","next_check":"2026-07-15T00:00:00.000Z","problems":[{"fix":"Run `pip install paradime-io` to install the package. If using a virtual environment, ensure it is activated before running your script.","cause":"The `paradime-io` package is not installed in the current Python environment, or the environment is not activated.","error":"ModuleNotFoundError: No module named 'paradime'"},{"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.","cause":"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.","error":"paradime.exceptions.AuthenticationError: Invalid API credentials provided"}]}