{"id":27457,"library":"tinybird","title":"Tinybird CLI","description":"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.","status":"active","version":"4.5.2","language":"python","source_language":"en","source_url":"https://github.com/tinybirdco/tinybird-cli","tags":["cli","data-platform","tinybird","real-time"],"install":[{"cmd":"pip install tinybird","lang":"bash","label":"Install via pip"}],"dependencies":[],"imports":[],"quickstart":{"code":"import tinybird\nimport os\n\ntb_token = os.environ.get('TB_TOKEN', '')\nclient = tinybird.Client(token=tb_token)\nprint(client.ping())","lang":"python","description":"Initialize Tinybird client with a token from environment variable and verify connectivity."},"warnings":[{"fix":"Upgrade to Python 3.10+.","message":"Python 3.9 support dropped in v4.0.0. Minimum Python is now 3.10.","severity":"breaking","affected_versions":">=4.0.0"},{"fix":"Migrate from `tb` CLI calls to `tinybird.Client` in your Python scripts.","message":"The old `tb` CLI command was deprecated in v4.3.0. Use the Python package API for programmatic access.","severity":"deprecated","affected_versions":">=4.3.0"},{"fix":"Set the environment variable `TB_TOKEN` with a valid Tinybird token, or pass it directly to the `Client` constructor.","message":"Token authentication is mandatory. The client will raise an authentication error if `TB_TOKEN` is not set or invalid.","severity":"gotcha","affected_versions":"all"},{"fix":"Implement retry logic with exponential backoff. The client does not automatically handle rate limits.","message":"Rate limiting is enforced on API calls (60 requests per minute by default). Exceeding the limit results in HTTP 429 responses.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'4.5.2':25 'cadenc':29 'cli':2,40,50 'command':4 'custom':18 'data':14,48,52 'data-platform':51 'deploy':13 'follow':31 'increment':34 'interfac':41 'latest':22 'line':5 'manag':8,11 'materi':19 'minor':32 'month':35 'offici':39 'pipe':16 'platform':49,53 'real':46,56 'real-tim':45,55 'releas':28 'sourc':15 'time':47,57 'tinybird':1,3,9,43,54 'tool':6 'version':23,33 'view':20 'workspac':10","created_at":"2026-05-01T17:46:21.553629+00:00","updated_at":"2026-05-01T17:46:21.553629+00:00","problems":[{"fix":"Run `pip install tinybird` to install the package.","cause":"The package 'tinybird' is not installed or installed in a different environment.","error":"ModuleNotFoundError: No module named 'tinybird'"},{"fix":"Use `from tinybird import Client` or `import tinybird; client = tinybird.Client(...)`.","cause":"Wrong import path. In version 4.x, the main class is `tinybird.Client`.","error":"ImportError: cannot import name 'Client' from 'tinybird'"},{"fix":"Set the environment variable `TB_TOKEN` to a valid token, or pass a valid token string to the `Client` constructor.","cause":"The provided Tinybird token is missing, empty, or invalid.","error":"tinybird.exceptions.AuthenticationError: Invalid token"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"tb","cli_version":"tb, version 4.5.7 (rev 02e83cb)","type":"library","homepage":"https://www.tinybird.co/docs/forward/commands","github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/tinybird/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","devops","http-networking"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-05-01","next_check":"2026-07-30","install_tag":null}}