tinybird-python-sdk-guidelines

# 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