Labsco
tinybirdco logo

tinybird-python-sdk-guidelines

★ 19

by tinybirdco · part of tinybirdco/tinybird-agent-skills

Tinybird Python SDK for defining datasources, pipes, and queries in Python. Use when working with tinybird-sdk, Python Tinybird projects, or data ingestion and…

🔥🔥🔥✓ VerifiedFreeQuick setup
#git
🧩 One of 5 skills in the tinybirdco/tinybird-agent-skills package — works on its own, and pairs well with its siblings.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

by tinybirdco

Tinybird Python SDK for defining datasources, pipes, and queries in Python. Use when working with tinybird-sdk, Python Tinybird projects, or data ingestion and… npx skills add https://github.com/tinybirdco/tinybird-agent-skills --skill tinybird-python-sdk-guidelines Download ZIPGitHub19

Tinybird Python SDK Guidelines

Guidance for using the tinybird-sdk package to define Tinybird resources in Python.

When to Apply

  • Installing or configuring tinybird-sdk

  • Defining datasources, pipes, or endpoints in Python

  • Creating Tinybird clients in Python

  • Using data ingestion or queries in Python

  • Running tinybird dev/build/deploy commands for Python projects

  • Migrating from legacy .datasource/.pipe files to Python

  • Defining connections (Kafka, S3, GCS)

  • Creating materialized views, copy pipes, or sink pipes

Rule Files

  • rules/getting-started.md

  • rules/configuration.md

  • rules/defining-datasources.md

  • rules/defining-endpoints.md

  • rules/client.md

  • rules/low-level-api.md

  • rules/cli-commands.md

  • rules/connections.md

  • rules/materialized-views.md

  • rules/copy-sink-pipes.md

  • rules/tokens.md

Quick Reference

  • Install: pip install tinybird-sdk

  • Initialize: tinybird init

  • Dev mode: tinybird dev (uses configured dev_mode, typically branch)

  • Build: tinybird build (builds against configured dev target)

  • Deploy: tinybird deploy (deploys to main/production)

  • Preview in CI: tinybird preview

  • Migrate: tinybird migrate (convert .datasource/.pipe files to Python)

  • Server-side only; never expose tokens in browsers