databricks-cli

What it is and what it does

databricks-cli is a command-line tool that wraps Databricks REST APIs, allowing you to manage workspaces, jobs, clusters, and files from the terminal. It handles authentication via token or username/password, storing credentials in ~/.databrickscfg, and supports multiple connection profiles. The tool depends on click, requests, oauthlib, pyjwt, tabulate, six, and urllib3 to provide a lightweight CLI layer over HTTP calls.

However, this package is no longer actively maintained—the repository is archived, the last commit was 2023-10-05, and Databricks explicitly recommends migrating to CLI versions 0.200 and above or the dedicated Python SDK (databricks-sdk-py) for new work. It is marked as experimental and receives no bug fixes or feature updates.

Use it for:

• Scripting workspace operations (listing, creating, deleting directories) in shell automation or CI/CD pipelines.
• Managing Databricks jobs and clusters from the command line during development or testing.
• Uploading or downloading files to Databricks file systems in batch workflows.
• Quick ad-hoc queries or cluster management when GUI access is unavailable.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A command-line interface for interacting with Databricks REST APIs, now superseded by newer versions and a dedicated SDK.

No. The package is abandoned, explicitly superseded by newer versions and a dedicated SDK, and marked experimental. While it has low install friction and no known vulnerabilities, Databricks actively recommends against using it for new work. Install only if you are maintaining legacy scripts that cannot be migrated; for any new integration, use the recommended CLI 0.200+ or databricks-sdk-py instead.

Install

databricks-cli on PyPI

pip install databricks-cli

uv add databricks-cli

poetry add databricks-cli

Installing databricks-cli

Before you install

Low install friction with standard dependencies, but the package is abandoned as of 2023-10-05 and explicitly marked experimental. Databricks recommends version 0.200 and above instead.

License in practice

Apache License 2.0 (permissive) — you can use, modify, and distribute freely with attribution and no warranty.

Quickstart

pip install databricks-cli==0.18.0

databricks configure --token
# Enter hostname and auth token at prompt

databricks workspace ls

Requires Python >= 3.7; macOS users need a Python build with ssl.PROTOCOL_TLSv1_2 support (system Python may lack it).

Verify before relying

• Whether the package's 0.18.0 release works reliably with current Databricks API versions despite being abandoned.
• Compatibility with Databricks workspaces created after the package's final release date.
• Whether authentication via ~/.databrickscfg persists across newer Databricks platform changes.

Package facts

Evidence: databricks_cli-0.18.0-py2.py3-none-any.whl

Keywords: databricks, cli

Tags

More Utilities packages