Tinybird CLI
raw JSON → 4.5.2 verified Fri May 01 auth: no python
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.
pip install tinybird Common errors
error ModuleNotFoundError: No module named 'tinybird' ↓
cause The package 'tinybird' is not installed or installed in a different environment.
fix
Run
pip install tinybird to install the package. error ImportError: cannot import name 'Client' from 'tinybird' ↓
cause 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(...). error tinybird.exceptions.AuthenticationError: Invalid token ↓
cause 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. Warnings
breaking Python 3.9 support dropped in v4.0.0. Minimum Python is now 3.10. ↓
fix Upgrade to Python 3.10+.
deprecated The 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.
gotcha Token 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.
gotcha Rate 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.
Quickstart
import tinybird
import os
tb_token = os.environ.get('TB_TOKEN', '')
client = tinybird.Client(token=tb_token)
print(client.ping())