Polars Cloud

0.6.1 verified Fri May 01 auth: no python

Run Polars remotely, either in the Cloud or On-Prem. Version 0.6.1 requires Python >=3.10. Still in early development; release cadence is irregular.

pip install polars-cloud

Common errors

error AttributeError: module 'polars_cloud' has no attribute 'PolarsCloudSession' ↓

cause Incorrect import path; tried importing directly from module.

fix

Use 'from polars_cloud import PolarsCloudSession' instead of 'import polars_cloud'.

error polars_cloud.exceptions.AuthenticationError: Invalid token ↓

cause Token is malformed or expired.

fix

Regenerate a new personal access token from the Polars Cloud dashboard and set POLARS_CLOUD_TOKEN.

Warnings

gotcha The token passed to PolarsCloudSession must be a personal access token, not an API key. Using an API key will fail silently. ↓

fix Generate a personal access token from the Polars Cloud UI and use that.

breaking The package was previously named 'cloud-polar' in pre-release; imports and PyPI naming have changed. ↓

fix Upgrade by pip install polars-cloud and change imports to polars_cloud.

deprecated Using session.datasets() as a callable (without .list) is deprecated. Use session.datasets.list() instead. ↓

fix Replace session.datasets() with session.datasets.list().

Imports

PolarsCloudSession

from polars_cloud import PolarsCloudSession

Quickstart

Create a session and list datasets.

from polars_cloud import PolarsCloudSession

session = PolarsCloudSession(
    token=os.environ.get('POLARS_CLOUD_TOKEN', ''),
    url=os.environ.get('POLARS_CLOUD_URL', 'https://cloud.polars.tech')
)

# List available datasets
datasets = session.datasets.list()
print(datasets)