tinybird

library4.5.2pypypiunverified

Tinybird Command Line Tool for managing Tinybird Workspaces, managing and deploying Data Sources, Pipes, and custom Materialized Views. The latest version is 4.5.2, with a release cadence that follows minor version increments monthly. It is the official CLI interface for Tinybird's real-time data platform.

data devops http-networking

pip install tinybird

package ↗homepage ↗

INSTALL

IMPORT

SIG · TINYBIRD

tinybird

datapythonv4.5.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Initialize Tinybird client with a token from environment variable and verify connectivity.

import tinybird import os tb_token = os.environ.get('TB_TOKEN', '') client = tinybird.Client(token=tb_token) print(client.ping())

tb --version

Debug

Known issues

breakingPython 3.9 support dropped in v4.0.0. Minimum Python is now 3.10.

fix

Upgrade to Python 3.10+.

affects: >=4.0.0

deprecatedThe old `tb` CLI command was deprecated in v4.3.0. Use the Python package API for programmatic access.

fix

Migrate from `tb` CLI calls to `tinybird.Client` in your Python scripts.

affects: >=4.3.0

gotchaToken authentication is mandatory. The client will raise an authentication error if `TB_TOKEN` is not set or invalid.

fix

Set the environment variable `TB_TOKEN` with a valid Tinybird token, or pass it directly to the `Client` constructor.

affects: all

gotchaRate limiting is enforced on API calls (60 requests per minute by default). Exceeding the limit results in HTTP 429 responses.

fix

Implement retry logic with exponential backoff. The client does not automatically handle rate limits.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'tinybird'

The package 'tinybird' is not installed or installed in a different environment.

fix

Run `pip install tinybird` to install the package.

ImportError: cannot import name 'Client' from 'tinybird'

Wrong import path. In version 4.x, the main class is `tinybird.Client`.

fix

Use `from tinybird import Client` or `import tinybird; client = tinybird.Client(...)`.

tinybird.exceptions.AuthenticationError: Invalid token

The provided Tinybird token is missing, empty, or invalid.

fix

Set the environment variable `TB_TOKEN` to a valid token, or pass a valid token string to the `Client` constructor.

Upgrade

Version history

4.5.2latest on PyPI · released Apr 29, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

20 hits · last 30 days

node

OpenAI (training)

Resources

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

homepagehttps://www.tinybird.co/docs/forward/commands ↗