Registry / data / dask-gateway

dask-gateway

library2026.3.0pypypi✓ verified 86d ago

A client library for interacting with a Dask Gateway server, enabling scalable multi-tenant HPC and cloud deployments. Version 2026.3.0 supports Python ≥3.10. Released ~2x per year, stable API.

data devops workflow

pip install dask-gateway

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · DASK-GATEWAY

dask-gateway

datapythonv2026.3.0

Install

—

Import

—

Disk

—

Pass rate

0/ 10

Env Coverage0 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2026.3.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

2/3 runs

py 3.11

2/3 runs

py 3.12

2/3 runs

py 3.13

2/3 runs

py 3.9

2/3 runs

Code

Verified usage

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

GatewayCluster

✓ from dask_gateway import GatewayCluster

✗ from dask_gateway.client import GatewayCluster

GatewayCluster is a top-level alias for the client class; direct import from .client is internal and may break.

Gateway

✓ from dask_gateway import Gateway

✗ from dask_gateway.gateway import Gateway

Gateway is available at the top-level package; importing from .gateway is an internal path.

Creates a Dask Gateway cluster, scales to 2 workers, and gets a client.

import os from dask_gateway import GatewayCluster # Create a cluster with token auth (or env vars) cluster = GatewayCluster( address=os.environ.get('DASK_GATEWAY_ADDRESS', 'http://gateway:8080'), proxy_address=os.environ.get('DASK_GATEWAY_PROXY_ADDRESS', 'gateway:8786'), auth='jupyterhub' if os.environ.get('JUPYTERHUB_USER') else None ) cluster.scale(2) client = cluster.get_client() # Submit work client.close() cluster.close()

Debug

Known issues

breakingIn v2024.1.0, the default auth no longer falls back to 'jupyterhub'. You must explicitly pass `auth='jupyterhub'` or set environment variables.

fix

Pass `auth='jupyterhub'` when using JupyterHub, or configure `DASK_GATEWAY_AUTH` env var.

affects: >=2024.1.0

deprecatedThe `GatewayCluster.adapt()` method is deprecated. Use `auto_scale()` instead.

fix

Replace `cluster.adapt(...)` with `cluster.auto_scale(...)`.

affects: >=2023.10.0

gotchaWhen using Kerberos auth, the server must have the same Kerberos principal configured. Otherwise, authentication fails with a vague HTTP 401.

fix

Ensure Dask Gateway server has `kerberos.principal` set correctly in its config.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'dask_gateway'

dask-gateway not installed in the current Python environment.

fix

Run `pip install dask-gateway`.

dask_gateway.exceptions.GatewayError: 401 Unauthorized - authentication failed

Invalid or missing authentication credentials.

fix

Pass the correct `auth` parameter (e.g., `auth='jupyterhub'`) or set `DASK_GATEWAY_AUTH` environment variable.

TypeError: __init__() got an unexpected keyword argument 'proxy_address'

In older versions (pre-2023.1.0), the `proxy_address` parameter was not available.

fix

Upgrade dask-gateway: `pip install --upgrade dask-gateway`.

Upgrade

Version history

2026.3.0latest on PyPI · released Mar 31, 2026

Audit

Dependencies

daskrequiredCore dependency for distributed computing

pyyamlrequiredConfiguration parsing

tornadorequiredAsync HTTP client

kerberosoptionalKerberos authentication

Agent activity

21 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/dask/dask-gateway ↗

packagehttps://pypi.org/project/dask-gateway/ ↗

homepagehttps://gateway.dask.org ↗

docshttps://gateway.dask.org/ ↗