---
id: tinybird-python-sdk
version: "0.3.7"
license: unclear
license_treatment: unclear
maintenance: active
---

# tinybird-python-sdk — Python SDK for Tinybird

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

## What it is and what it does

The Tinybird Python SDK is a client library for programmatically interacting with Tinybird's data ingestion and API services. It provides both synchronous and asynchronous interfaces for sending NDJSON data to Tinybird Data Sources and making HTTP requests to Tinybird APIs. The package includes handlers for direct event logging and integration with litellm for capturing LLM call metadata.

The SDK manages in-memory buffering, handles rate limits automatically via the backoff dependency, and supports both standard requests and async operations via aiohttp. It includes non-blocking queue-based logging handlers to avoid blocking application threads. The documentation indicates that for managing Tinybird workspaces, data sources, or pipes, the tinybird-cli tool should be used instead.

Use it for:

- Stream application events and metrics into Tinybird for real-time analytics and monitoring.
- Capture LLM API calls from litellm with automatic metadata extraction and logging to Tinybird.
- Integrate Python logging into a Tinybird Data Source for centralized log aggregation.
- Ingest bulk NDJSON data from external sources via the Tinybird API without CLI tooling.
- Build non-blocking logging pipelines using queue-based handlers to avoid blocking application threads.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Ingest NDJSON data into Tinybird Data Sources and send requests to Tinybird APIs from Python, with support for both synchronous and asynchronous operations and logging integration.

Yes, if you are already using Tinybird and need to ingest data or logs from Python. The package is actively maintained, has low install friction, and covers common use cases. However, verify the license terms before use—the package does not declare an SPDX license—and confirm minimum Python version compatibility with your environment.

## Install

pip install tinybird-python-sdk
uv add tinybird-python-sdk
poetry add tinybird-python-sdk

## Installing tinybird-python-sdk

Before you install: Low install friction with three common runtime dependencies (requests, aiohttp, backoff). Actively maintained with recent releases; last commit 2026-06-29 and latest release 2025-06-06 indicate ongoing development.

License in practice: License status is unclear—no SPDX identifier or raw license text is declared in the package metadata, so you cannot verify the terms before use.

Quickstart:

pip install tinybird-python-sdk

from tinybird_python_sdk import Datasource

with Datasource('my_datasource', 'my_token') as ds:
    ds << {'key': 'value', 'key1': 'value1'}

Requires a valid Tinybird token and an existing Data Source in your Tinybird workspace.

Verify before relying:

- Minimum Python version requirement is not specified in the fact sheet.
- Whether the package is suitable for production workloads or still in early development.
- Rate limit handling behavior and retry strategy details beyond backoff dependency.
- Module structure and import paths for accessing Datasource and AsyncDatasource classes.

## Package facts

- License: not declared (unclear)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 181.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tinybird data ingestion python, ndjson logging to tinybird, tinybird api client, async tinybird datasource, litellm tinybird logging, tinybird events api sdk, data-ingestion, async-support, logging-integration

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