Registry / data / tinybird-cli

tinybird-cli

library6.4.1pypypiunverified

Tinybird CLI is a command-line tool for interacting with the Tinybird platform, used for data ingestion, query execution, and workspace management. Current version 6.4.1 supports Python <3.14,>=3.10, with quarterly releases.

data devops

pip install tinybird-cli

package ↗homepage ↗

INSTALL

IMPORT

SIG · TINYBIRD-CLI

tinybird-cli

datapythonv6.4.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Initialize the client with a Tinybird token from the TB_TOKEN environment variable and list workspaces.

import os from tinybird_cli import Auth, WorkspaceClient token = os.environ.get('TB_TOKEN', '') auth = Auth(token=token) client = WorkspaceClient(auth=auth) workspaces = client.list() print(workspaces)

tb --version

Debug

Known issues

breakingVersion 6.0.0 renamed the package from `tinybird` to `tinybird-cli` and changed the import module from `tinybird` to `tinybird_cli`.

fix

Update imports: from tinybird_cli import ... instead of from tinybird import ...

affects: <6.0.0

deprecatedAuthentication via `TB_TOKEN` environment variable is deprecated since v5.0.0; use `Auth(token=...)` instead.

fix

Replace `os.environ.get('TB_TOKEN')` with explicit `Auth(token=...)` instantiation.

affects: <5.0.0

gotchaThe CLI commands in documentation may not match Python API method names. For example, `tb workspace list` corresponds to `WorkspaceClient.list()`.

fix

Refer to the official Python SDK docs for method signatures instead of CLI help.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'tinybird'

Package renamed from `tinybird` to `tinybird-cli` in v6.0.0, and import module changed to `tinybird_cli`.

fix

Install the correct package: pip install tinybird-cli, then import from tinybird_cli import ...

AttributeError: module 'tinybird_cli' has no attribute 'Client'

The old `Client` class was removed in v6.0.0; replaced by `Auth` and `WorkspaceClient`.

fix

Use `from tinybird_cli import Auth, WorkspaceClient` and construct with `Auth(token=...)`.

Upgrade

Version history

6.4.1latest on PyPI · released May 6, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

13 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

packagehttps://pypi.org/project/tinybird-cli/ ↗

homepagehttps://www.tinybird.co/docs/cli ↗