{"id":46633,"library":"tinybird-python-sdk","title":"Tinybird Python SDK","description":"Python SDK for interacting with the Tinybird API, enabling data ingestion, querying, and pipeline management. Current version is 0.3.7, with frequent releases.","status":"active","version":"0.3.7","language":"python","source_language":"en","source_url":"https://github.com/tinybirdco/tinybird-python-sdk","tags":["tinybird","sdk","data-pipeline"],"install":[{"cmd":"pip install tinybird-python-sdk","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"HTTP client for API calls","package":"requests","optional":false}],"imports":[{"wrong":"from tinybird.sdk import Tinybird","symbol":"logging","correct":"from tb import logging"}],"quickstart":{"code":"from tinybird.sdk import Tinybird\nimport os\n\ntoken = os.environ.get('TB_TOKEN', '')\nclient = Tinybird(token=token)\n# Example: query a pipe\nresult = client.query('SELECT * FROM my_pipe')\nprint(result)","lang":"python","description":"Initialize the SDK with a token and run a query."},"warnings":[{"fix":"Pin to a specific version, e.g., tinybird-python-sdk==0.3.7","message":"The SDK is in early development (0.x). Breaking changes may occur at any minor version. Always pin your dependency.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Always pass token and optionally api_url explicitly.","message":"The 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.","severity":"gotcha","affected_versions":"all"},{"fix":"Wrap calls in error handling and validate response structure.","message":"The 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.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'0.3.7':22 'api':11 'current':19 'data':13,29 'data-pipelin':28 'enabl':12 'frequent':24 'ingest':14 'interact':7 'manag':18 'pipelin':17,30 'python':2,4 'queri':15 'releas':25 'sdk':3,5,27 'tinybird':1,10,26 'version':20","created_at":"2026-06-07T13:00:52.439063+00:00","updated_at":"2026-06-07T13:00:52.439063+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["analytics","database"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}