Tinybird Python SDK Guidelines

SkillDev tools

Lets your agent write Python code to define Tinybird datasources, pipes, and queries.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Tinybird Python SDK Guidelines skill

About this capability

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.

What this skill tells your AI

The instructions your AI receives, as published by mapletechlabs/maple in .agents/skills/tinybird-python-sdk-guidelines/SKILL.md and read by ahel’s review.

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

Signals

GitHub stars
2k
Forks
117
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
tinybird-python-sdk-guidelines
Source
github.com/mapletechlabs/maple