Agent Skill · Tinybird

tinybird-python-sdk-guidelines

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

View SKILL.md on GitHub → Source repository Provider profile

Provider: Tinybird Path in repo: skills/tinybird-python-sdk-guidelines/SKILL.md

Skill body

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