{"id":28393,"library":"tinybird-cli","title":"Tinybird CLI","description":"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.","status":"active","version":"6.4.1","language":"python","source_language":"en","source_url":"https://github.com/tinybirdco/tinybird-cli","tags":["cli","tinybird","data-pipeline"],"install":[{"cmd":"pip install tinybird-cli","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[],"quickstart":{"code":"import os\nfrom tinybird_cli import Auth, WorkspaceClient\n\ntoken = os.environ.get('TB_TOKEN', '')\nauth = Auth(token=token)\nclient = WorkspaceClient(auth=auth)\nworkspaces = client.list()\nprint(workspaces)","lang":"python","description":"Initialize the client with a Tinybird token from the TB_TOKEN environment variable and list workspaces."},"warnings":[{"fix":"Update imports: from tinybird_cli import ... instead of from tinybird import ...","message":"Version 6.0.0 renamed the package from `tinybird` to `tinybird-cli` and changed the import module from `tinybird` to `tinybird_cli`.","severity":"breaking","affected_versions":"<6.0.0"},{"fix":"Replace `os.environ.get('TB_TOKEN')` with explicit `Auth(token=...)` instantiation.","message":"Authentication via `TB_TOKEN` environment variable is deprecated since v5.0.0; use `Auth(token=...)` instead.","severity":"deprecated","affected_versions":"<5.0.0"},{"fix":"Refer to the official Python SDK docs for method signatures instead of CLI help.","message":"The CLI commands in documentation may not match Python API method names. For example, `tb workspace list` corresponds to `WorkspaceClient.list()`.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Install the correct package: pip install tinybird-cli, then import from tinybird_cli import ...","cause":"Package renamed from `tinybird` to `tinybird-cli` in v6.0.0, and import module changed to `tinybird_cli`.","error":"ModuleNotFoundError: No module named 'tinybird'"},{"fix":"Use `from tinybird_cli import Auth, WorkspaceClient` and construct with `Auth(token=...)`.","cause":"The old `Client` class was removed in v6.0.0; replaced by `Auth` and `WorkspaceClient`.","error":"AttributeError: module 'tinybird_cli' has no attribute 'Client'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}