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.3

  • Changed tb init now defaults to CLI projects when –type is not provided.

  • Fixed GitHub and GitLab CI templates generated by tb init now run tb –local build and tb –local test run.

4.5.2

  • Fixed tb build on branches now runs as an asynchronous job, avoiding timeouts on long-running executions.

4.5.1

  • Fixed tb open now generates the correct UI URL when running against Tinybird Local.

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.4.dev0.tar.gz (450.7 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.4.dev0-py3-none-any.whl (438.1 kB view details)

Uploaded Python 3

File details

Details for the file tinybird-4.5.4.dev0.tar.gz.

File metadata

  • Download URL: tinybird-4.5.4.dev0.tar.gz
  • Upload date:
  • Size: 450.7 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.4.dev0.tar.gz
Algorithm Hash digest
SHA256 dc3940b1c2eacb6455a848f0290c18ba49a30b30df68076bfe2d44ecd4d7bcf4
MD5 4c6b0d93b3d8af4b720392f036a19f8b
BLAKE2b-256 d14202a759d374c13bb46829edfa3efc27deb33c581c35b05782bc1dd6f96b83

See more details on using hashes here.

File details

Details for the file tinybird-4.5.4.dev0-py3-none-any.whl.

File metadata

  • Download URL: tinybird-4.5.4.dev0-py3-none-any.whl
  • Upload date:
  • Size: 438.1 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.4.dev0-py3-none-any.whl
Algorithm Hash digest
SHA256 ba664ad6039c2aa942e563054a871b2980129e1f9cde543eb3defda9a92adde9
MD5 cc02ab579177b52b2184d5a45b156ab7
BLAKE2b-256 45b1416da44d0b676a75ca9e6fa82c41ab4e3a408e85ec2c7bb521c72248a130

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