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

  • Fixed Issue when executing command tb migrate-to-forward

4.5.5

  • Fixed Issue when running executing command tb –cloud deploy –check

4.5.4

  • Added tb migrate-to-forward to help users migrate Classic workspaces to Forward

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.6.tar.gz (452.5 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.6-py3-none-any.whl (439.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: tinybird-4.5.6.tar.gz
  • Upload date:
  • Size: 452.5 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.6.tar.gz
Algorithm Hash digest
SHA256 65e9e22b570849e0e465fbce898f5724110d740fcd3664feea362c340bc0a1c9
MD5 714df5f5c5dae9344619fca3d213f5b3
BLAKE2b-256 96cf908e25a367a4a41ae749f131f1e774a0b2860ab0d575c60c0236a61f3b92

See more details on using hashes here.

File details

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

File metadata

  • Download URL: tinybird-4.5.6-py3-none-any.whl
  • Upload date:
  • Size: 439.9 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 a6094a8a5ac56d33ee49e2f86b2cd366bc015fdcc647594011d6ffaf001adfbf
MD5 2cff3bf2f545acae326cd67f304344f3
BLAKE2b-256 6c1053eb21384fc422d8fe2fd5cea29727d6ab8209cb3d4c7cfc4ccf23eb2995

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