tinybird-python-sdk-guidelines

Original：🇺🇸 English

Translated

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.

2installs

Sourcetinybirdco/tinybird-agent-skills

Added on2026-03-26

NPX Install

npx skill4agent add tinybirdco/tinybird-agent-skills tinybird-python-sdk-guidelines

SKILL.md Content

View Translation Comparison →

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