---
id: tinybird
version: "4.6.14"
license: unclear
license_treatment: unclear
maintenance: active
---

# tinybird — Tinybird Command Line Tool

License: unclear · Maintenance: active · Downloads: 170.1K/mo

## 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 above — verify before relying.

Command-line interface for managing Tinybird data projects, including datasource operations, pipe deployment, and local development workflows.

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

pip install tinybird
uv add tinybird
poetry add tinybird

## Installing tinybird

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.

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 cli

Requires Python 3.10 or later. Docker is needed for `tb local` commands. AWS credentials or Kafka bootstrap servers required for connector operations.

Verify 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_current
- Install friction: low
- Maintenance: active
- Downloads: 170.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tinybird cli command line, data pipeline deployment tool, datasource management cli, tinybird local development, clickhouse data project management, kafka connector setup, csv parquet ndjson import, data-pipeline, cli-tool, devops

[View on SkillFed](https://skillfed.io/packages/tinybird) · [View on PyPI](https://pypi.org/project/tinybird/)