Agent-Skills.md

Agent Skills: 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.

UncategorizedID: tinybirdco/tinybird-agent-skills/tinybird-python-sdk-guidelines
14

Install this agent skill to your local

pnpm dlx add-skill https://github.com/tinybirdco/tinybird-agent-skills/tree/HEAD/skills/tinybird-python-sdk-guidelines

Skill Files

Browse the full folder contents for tinybird-python-sdk-guidelines.

Download Skill

Loading file tree…

skills/tinybird-python-sdk-guidelines/SKILL.md

Skill Metadata

Name
tinybird-python-sdk-guidelines
Description
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.

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