Skip to main content

SQLTide
by SQLStack

Streaming pipelines for ClickHouse, in typed SQL.

Change your SQL, see exactly what will rebuild, and replay it from retained stream history.
Website · Get started · Docs · Demo

PyPI Verification Python versions License

SQLTide brings dbt-style authoring and deployment to streaming. Models compile into ClickHouse tables and materialized views, every build shows its plan first, and a change to your logic is rebuilt from retained Kafka history.

uv tool install sqltide        # or: pip install sqltide

SQLTide lineage view showing the orders demo pipeline

Key features

  • Typed SQL models. Explicit output types, __source() and __ref() dependencies, and offline compilation with no warehouse connection.
  • Replay-aware builds. Affected models are reconstructed from retained stream history.
  • Plans before changes. sqt plan is read-only, and sqt build replans against current warehouse state before it runs.
  • Staged deployments. Build virtually, then audit, promote, and roll back.
  • Quality built in. SQL tests, audits, sensors, and SQLClean rules and formatting.
  • A UI for operating it. Sources, lag, lineage, plans, runs, and quality in sqt dev, with trusted-proxy or password authentication for shared installations.

Example

A source and a model:

sources:
  - name: orders
    kind: kafka
    broker_list: kafka:9092
    topic: source.orders
    replay_boundary:
      mode: offsets
MODEL (
  engine "MergeTree()",
  order_by ["order_id", "_replay_partition", "_replay_offset"],
);

SELECT
  order_id::String AS order_id,
  _replay_partition::Int32 AS _replay_partition,
  _replay_offset::Int64 AS _replay_offset,
  _replay_timestamp::DateTime64(3) AS _replay_timestamp
FROM __source("orders")

Quick start

sqt discover    # inspect authored resources
sqt compile     # validate offline
sqt plan        # read-only warehouse plan
sqt build       # confirm and execute
sqt test
sqt audit
sqt dev         # local UI at 127.0.0.1:8000

The orders demo runs the whole workflow locally with Redpanda and ClickHouse. See the quickstart to start your own project.

Documentation

License

Apache-2.0

Metadata

Release files for sqltide 0.65.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sqltide 0.65.1
File Size Uploaded Provenance Actions
sqltide-0.65.1.tar.gz 2.1 MB With provenance Details for sqltide-0.65.1.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for sqltide 0.65.1
File Actions
sqltide-0.65.1-cp312-abi3-win_amd64.whl CPython 3.12 abi3 Windows x86-64 Details for sqltide-0.65.1-cp312-abi3-win_amd64.whl
sqltide-0.65.1-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.12 abi3 Linux glibc 2.17+ x86-64 Details for sqltide-0.65.1-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
sqltide-0.65.1-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.12 abi3 Linux glibc 2.17+ ARM64 Details for sqltide-0.65.1-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
sqltide-0.65.1-cp312-abi3-macosx_11_0_arm64.whl CPython 3.12 abi3 macOS 11.0+ ARM64 Details for sqltide-0.65.1-cp312-abi3-macosx_11_0_arm64.whl
sqltide-0.65.1-cp312-abi3-macosx_10_12_x86_64.whl CPython 3.12 abi3 macOS 10.12+ x86-64 Details for sqltide-0.65.1-cp312-abi3-macosx_10_12_x86_64.whl

Total release size: 92.7 MB

Release files / sqltide-0.65.1.tar.gz

Download URL sqltide-0.65.1.tar.gz
Size 2.1 MB
Tags Source
SHA-256 checksum
How to use checksums
191f2f4e66523e9a0974cfda0c7f9ddc028305e54e5153a8f456621a920064f1
BLAKE2b-256 checksum
How to use checksums
71cf0e9010efe3bd37c75562ae42549aac090b292ea9638316a43b66f3a5ec41
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Release files / sqltide-0.65.1-cp312-abi3-win_amd64.whl

Download URL sqltide-0.65.1-cp312-abi3-win_amd64.whl
Size 19.6 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
552ac8188a7aa7aac91bba62a42ed4f2fdb39d33668b1d1139e8f1c56646ac7d
BLAKE2b-256 checksum
How to use checksums
d47ca92393d5b273f614f3bfbf86e7adfc5cd6d9222a61465f522988083b5d0a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Release files / sqltide-0.65.1-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL sqltide-0.65.1-cp312-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 18.0 MB
Tags CPython 3.12 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
45abfb25d355e41a762eee7c747155c55128c39dcfee6f766a93b99726d1c672
BLAKE2b-256 checksum
How to use checksums
3c4f6758d9c0864ebac9b9a8c5037965978718e89fbc9e2d4d3985f3a0c920e2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Release files / sqltide-0.65.1-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL sqltide-0.65.1-cp312-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 17.5 MB
Tags CPython 3.12 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
3f557c44eefb1ce756b392be40132b5a132ea1892ee941e400ee3d854d618582
BLAKE2b-256 checksum
How to use checksums
37a965135baedeaaaf2dd26b4cc4d328635d0eb3b5b28a202dc4d2396237ba06
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Release files / sqltide-0.65.1-cp312-abi3-macosx_11_0_arm64.whl

Download URL sqltide-0.65.1-cp312-abi3-macosx_11_0_arm64.whl
Size 17.5 MB
Tags CPython 3.12 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
dccce66c33374a04e08454cfe59dd1b24ea93f92ef7b1aee846a4f1d27b5b50c
BLAKE2b-256 checksum
How to use checksums
a575ab43b9a8a519456b748dde05c70af272a6fd975b3f030e7bcada7c779fa4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Release files / sqltide-0.65.1-cp312-abi3-macosx_10_12_x86_64.whl

Download URL sqltide-0.65.1-cp312-abi3-macosx_10_12_x86_64.whl
Size 17.9 MB
Tags CPython 3.12 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
dffa8b403f2f1cd87309e33d1636a2a1d1cd85f73eb6617b2b8472e1c406423c
BLAKE2b-256 checksum
How to use checksums
f505df9e3c84a8bddc3da6c3ea8f7d461a6b0dc58fc6547b4d6dbec65b80eb2c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Security for sqltide 0.65.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for sqltide-0.65.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.65.1 This release

6 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page