Skip to main content

Tinybird Command Line Tool

Project description

The Tinybird command-line tool allows you to use all the Tinybird functionality directly from the command line. Additionally, it includes several functions to create and manage data projects easily.

Changelog

4.5.0

  • Added tb copy pause and tb copy resume commands to pause and resume copy pipes.

4.4.2

  • Added tb build and tb dev now display git branch, Tinybird branch name, and dashboard URL before building. In local mode, a separate workspace is created per git branch.

4.4.1

  • Changed CLI messages now show uv run tinybird for python-sdk projects and npx tinybird for ts-sdk projects instead of tb.

4.4.0

  • Added tb copy run has a new –on-demand-compute flag to use on-demand compute instances for copy jobs.

4.3.2

  • Changed CLI API requests now set the from parameter dynamically from the detected project type (python-sdk, ts-sdk, or cli) instead of using a hardcoded source.

4.3.1

  • Fixed tb deploy –help and tb deployment create –help.

4.3.0

  • Changed tb deploy –auto/–no-auto keeps the same CLI behavior (default –auto) while using server-side deployment auto_promote under the hood when enabled.

4.2.2

  • Changed Improved the max-depth warning message to clarify when the warning can be safely ignored.

4.1.1

  • Changed tb init now installs tinybird-python-sdk-guidelines when selecting the Python SDK project type.

  • Changed tb init now defaults dev_mode to branch and persists that value in tinybird.config.json.

4.1.0

  • Added New WORKSPACE:DEPLOY scope for static tokens. To create one, run: tb –cloud token create static deploy –scope “WORKSPACE:DEPLOY”

4.0.0

  • Removed Tinybird Code entry points and AI-assisted command paths (tb –prompt, tb datasource create –prompt, tb test create, and tb mock).

  • Changed tb init is now the project scaffolding command.

  • Changed tb build now uses the dev_mode configuration from the project JSON config file.

  • Changed tb deploy now uses the dev_mode configuration from the project JSON config file.

3.5.4

  • Fixed Pulling vendored data sources from a Classic workspace to migrate to Forward now includes all workspaces in SHARED_WITH.

3.5.3

  • Fixed Support SASL_PLAINTEXT as a Kafka security protocol, fixing connections to brokers that use SASL authentication without TLS (e.g. WarpStream).

3.5.2

  • Changed tb deploy –auto/–no-auto keeps the same CLI behavior (default –auto) while using server-side deployment auto_promote under the hood when enabled.

3.5.1

  • Fixed Support special characters in workspace names in the login flow.

3.5.0

  • Changed AI-assisted CLI commands now show a deprecation warning indicating they will be removed in a future major release and include agent skills guidance (npx skills add @tinybirdco/tinybird-agent-skills).

3.4.0

  • Changed Prompt-based AI flows now print a deprecation warning (tb –prompt, tb create –prompt, tb datasource create –prompt, tb test create, tb mock) ahead of their removal in a future release.

3.3.2

  • Added tb logs command to query service observability data sources from the CLI.

  • Added support for –start, –end, –source, –limit, and –expand in tb logs.

  • Added support for –source ‘*’ in tb logs to query all supported sources.

  • Changed default tb logs sources to tinybird.datasources_ops_log, tinybird.pipe_stats_rt, and tinybird.jobs_log.

  • Changed tb logs table output to show full datetime (YYYY-MM-DD HH:MM:SS) in TIME and to hide temporal fields from DETAILS.

  • Fixed tb logs to correctly parse SQL responses returned as JSON strings.

3.3.1

  • Changed Tinybird Code (tb / tb –prompt) no longer prompts users to auto-update the CLI when starting an agent session.

3.3.0

  • Added tb datasource stop and tb datasource start commands to pause/resume Kafka ingestion in forward branches

  • Added POST /v0/datasources/{name}/sample API endpoint to import sample data from S3/GCS connections in forward branches

  • Changed --with-connections flag for tb build and tb deploy is now stable (previously experimental)

3.0.2

  • Changed IMPORT_FORMAT is now optional for S3/GCS data sources and will be automatically inferred from the file extension if not provided

3.0.1

  • Experimental Added hidden –with-connections flag to tb build and tb dev commands for enabling connection datasources (S3, Kafka, GCS) in branches. This is an experimental feature and is not yet publicly documented.

3.0.0

  • Removed Python 3.9 support. The minimum supported Python version is now 3.10.

  • Removed BigQuery and Snowflake connector support from Forward CLI build and deployment commands

1.1.14

  • Changed tb deploy First deployment will not show feedback related to deleting the previous deployment, as it does not exist yet.

1.1.13

  • Changed tb workspace members subcommands now use the token from context instead of asking for a user token.

  • Removed Guest role option from tb workspace members, only Viewer role remains.

1.1.12

  • Added support for formatting connection files with tb fmt command.

1.1.11

  • Changed Improve first deployment feedback message.

  • Changed do not show tb materialization populate command as it is not supported.

1.1.10

  • Changed Tinybird Code now will not load all the resources content at start and instead will load them on demand using its own tools: read_datafile and search_datafiles.

1.1.9

  • Fixed tb dev won’t show a multiple environment flags error when a command is passed with an environment flag.

1.1.8

  • Fixed tb deploy will return a meaningful error in case of invalid cloud provider credentials instead of returning Internal Server Error.

1.1.7

  • Fixed tb connection create s3 now will show a warning if the AWS credentials are not available and will continue without Tinybird Local.

1.1.6

  • Changed Using more than one environment flag (–cloud, –local, –branch) at the same time will raise an error.

1.1.5

  • Changed Changed the output of tb deploy to show real deployment order of events.

  • Changed First deployment no longer shows the hint to ingest data if it detects data already planned to be ingested.

1.1.4

  • Changed tb connection create s3 now will ask for the environments to create the secret in (Local and Cloud) and will use the corresponging AWS account IDs in the generated trust policy.

1.1.3

  • Changed tb datasource create –s3 now will generate the exact schema from the bucket preview instead of a generic data column.

1.1.2

  • Changed tb datasource create wording.

1.1.1

  • Added Support for previewing S3 connections data in tb connection data command.

1.1.0

  • Added tb fmt command to format .datasource and .pipe files. Not supported yet for .connection files.

1.0.7

  • Changed tb datasource create –kafka now includes the Kafka meta columns explicitly in the generated file.

1.0.6

  • Changed tb deploy will raise a warning when using engine parameters that are not useful for the picked engine.

1.0.5

  • Added Internal changes

1.0.4

  • Changed tb login help text has been updated to provide more clarity on the available options.

1.0.3

  • Changed tb login now will warn the user if they are trying to login from a different folder than the last one and will ask for confirmation to continue.

1.0.2

  • Changed If connection name is not provided in tb connection data, it will prompt the user to select a connection from the list of available connections.

1.0.1

  • Added Support for schema_registry_url and auto_offset_reset when creating a Kafka connection.

1.0.0

  • Released Version 1.0.0, from now on the tinybird-cli package uses the standard semver convention for stable versions. Development versions will be tagged as with the .devX suffix where X is an integer number.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tinybird-4.5.0.tar.gz (449.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tinybird-4.5.0-py3-none-any.whl (437.2 kB view details)

Uploaded Python 3

File details

Details for the file tinybird-4.5.0.tar.gz.

File metadata

  • Download URL: tinybird-4.5.0.tar.gz
  • Upload date:
  • Size: 449.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for tinybird-4.5.0.tar.gz
Algorithm Hash digest
SHA256 d0389d47852147cd23718a11a689e591f39b1e1f1af59f2fdfc7d4221e81582e
MD5 ab5dbfb5fc38b1e3c44134855e877ac2
BLAKE2b-256 c6969dd1a84c2a23222ab2b0caa52b6dd528d6c417c859103fdd2de572463dce

See more details on using hashes here.

File details

Details for the file tinybird-4.5.0-py3-none-any.whl.

File metadata

  • Download URL: tinybird-4.5.0-py3-none-any.whl
  • Upload date:
  • Size: 437.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for tinybird-4.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8d05ecc974ea6d217deeaaeb16c48784f5475e62bd3198ed884eeb96a560cec5
MD5 aba99609ae769c1c620ce8539b876500
BLAKE2b-256 fbfcbf7174646f03530cb88742506357b62719c7c436e280dc8d8355c19877ec

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page