tinybird
Tinybird Command Line Tool
Decision gist · record as of 2026-08-14
Yes, if you are actively developing Tinybird projects and want to manage them from the command line and version control. The tool is actively maintained, has no known vulnerabilities, and integrates well with CI/CD pipelines. Install with caution if your environment has constrained disk or network resources, as the 27 dependencies include heavy packages like Docker and boto3. Verify the license terms before using in proprietary work, as the license status is currently unclear.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Docker is needed for `tb local` commands.
- AWS credentials or Kafka bootstrap servers required for connector operations.
License · maintenance · safety
(unclear) — License status is unclear; no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in proprietary or restricted contexts.
last release 2026-07-28 (17 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 170,077 downloads/mo, #10,404 on PyPI
Alternatives
Verify before relying
pip install tinybird
tb --help
tb login
tb init --type cli- Whether the package is open-source or proprietary (license treatment is unclear)
- Whether all 27 runtime dependencies are always required or only for specific commands
- Compatibility with Windows and macOS beyond the native architecture fix in 4.6.6
What it is and what it does
Tinybird CLI is a command-line tool that brings Tinybird's data platform functionality to your terminal, letting you manage datasources, deploy data pipes, and orchestrate projects without leaving the shell. It handles CSV, NDJSON, and Parquet file imports, manages Kafka and DynamoDB connectors, and supports local development via Docker containers. The tool is designed for teams building data projects in version control, with features like branch management, CI/CD integration templates, and secret handling for sink configurations.
The CLI integrates deeply with Git workflows—it can auto-detect branches, create isolated workspaces per branch, and generate GitHub/GitLab CI templates. It also includes utilities for authentication, project initialization, and migration from Classic to Forward workspaces. With 27 runtime dependencies spanning async file handling, container orchestration, and SQL formatting, it's a fairly heavyweight tool aimed at production data engineering rather than lightweight scripting.
Use it for
- Initialize and scaffold a new Tinybird data project with `tb init`, then deploy pipes and datasources from version control.
- Ingest local CSV, Parquet, or NDJSON files into Tinybird datasources using `tb datasource append` with optional async job tracking.
- Set up Kafka or DynamoDB connectors interactively with `tb connection create`, including SASL OAUTHBEARER for AWS MSK.
- Run `tb local` to spin up a local Tinybird instance in Docker for development and testing before cloud deployment.
- Manage multi-branch workflows with `tb branch create/clear`, with each Git branch getting its own isolated workspace.
- Deploy and validate data pipelines with `tb deploy` and `tb build`, catching parameter errors and secret misconfigurations early.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are actively developing Tinybird projects and want to manage them from the command line and version control.
The tool is actively maintained, has no known vulnerabilities, and integrates well with CI/CD pipelines. Install with caution if your environment has constrained disk or network resources, as the 27 dependencies include heavy packages like Docker and boto3. Verify the license terms before using in proprietary work, as the license status is currently unclear.
Install
tinybird on PyPI
Before you install
Low friction installation with a pure Python wheel. Active maintenance with releases every 2–3 weeks. Requires Python 3.10 or later. The 27 runtime dependencies include heavy packages like boto3, docker, and confluent-kafka, which may add setup time depending on your environment.
Requires Python 3.10 or later. Docker is needed for `tb local` commands. AWS credentials or Kafka bootstrap servers required for connector operations.
License in practice
License status is unclear; no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in proprietary or restricted contexts.
Quickstart
pip install tinybird
tb --help
tb login
tb init --type cliVerify before relying
- Whether the package is open-source or proprietary (license treatment is unclear)
- Whether all 27 runtime dependencies are always required or only for specific commands
- Compatibility with Windows and macOS beyond the native architecture fix in 4.6.6
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release <3.14,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 27 packagesaiofilesboto3clickclickhouse-toolsetcoloramaconfluent-kafkacryptographycroniterdockerGitPythonhumanfriendlyprompt_toolkitlogfire-apipydanticpyperclippyyamlrequestsshandy-sqlfmttoposorttornadourllib3watchdogwheelpackagingthefuzzpython-dotenvpyjwt |
| Maintenance | Actively maintained 17 days since the last release |
| First released | |
| Downloads | 170,077 / month, #10,404 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: tinybird-4.6.14-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “tinybird cli command line”
- tinybirdCommand-line interface for managing Tinybird data projects, including…
- tinybird-python-sdkIngest NDJSON data into Tinybird Data Sources and send requests to…
- pytest-tinybirdA pytest plugin that automatically posts test results to Tinybird's…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also tinybird-python-sdk · kafka-connect-py · pytest-tinybird · lamin_cli · kappa · flet-cli · parquet-tools · ms-fabric-cli · fastapi-cloud-cli · comfy-cli