Registry / analytics / tinybird-python-sdk

tinybird-python-sdk

JSON →
library0.3.7pypypi✓ verified 80d ago

Python SDK for interacting with the Tinybird API, enabling data ingestion, querying, and pipeline management. Current version is 0.3.7, with frequent releases.

pip install tinybird-python-sdk
INSTALL
IMPORT
SIG · TINYBIRD-PYTHON-SD
T
tinybird-python-sdk
analyticspythonv0.3.7
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

logging
from tb import logging
from tinybird.sdk import Tinybird

Initialize the SDK with a token and run a query.

from tinybird.sdk import Tinybird import os token = os.environ.get('TB_TOKEN', '') client = Tinybird(token=token) # Example: query a pipe result = client.query('SELECT * FROM my_pipe') print(result)
Debug
Known issues
breakingThe SDK is in early development (0.x). Breaking changes may occur at any minor version. Always pin your dependency.
fix
Pin to a specific version, e.g., tinybird-python-sdk==0.3.7
affects: <1.0.0
gotchaThe Tinybird() constructor may require a token or API URL; but if not provided, it might attempt to read environment variables TB_TOKEN and TB_API_URL. Overlooking this can cause silent failures.
fix
Always pass token and optionally api_url explicitly.
affects: all
gotchaThe SDK's query method returns raw JSON; the shape of the response can change with different Tinybird plans or API versions. Do not assume a static schema.
fix
Wrap calls in error handling and validate response structure.
affects: all
Upgrade
Version history
0.3.7latest on PyPI · released Jun 6, 2025
Audit
Dependencies
requestsrequiredHTTP client for API calls
Agent activity
30 hits · last 30 days
node
28
OpenAI (training)
1
Resources

No resource links recorded.

tinybird-python-sdk — pip install tinybird-python-sdk · libregistry