Skip to main content

Lightweight CLI for Recce Cloud operations

Project description

Recce: DataRecce.io

Helping data teams preview, validate, and ship data changes with confidence.

install   pipy   Python   downloads   license   Slack   InfuseAI Discord Invite  

Book us with Cal.com

Trust, Verify, Ship

Cut dbt review time by 90% and ship accurate data fast

Recce gives data teams a faster, more reliable way to understand, review, and ship changes without all the guesswork or manual overhead.

Quick Start

Installation

Recce offers two packages to fit different use cases:

For full local development and Recce Cloud features:

pip install -U recce
recce server

For CI/CD artifact uploads only (lightweight):

pip install -U recce-cloud
recce-cloud upload

The recce-cloud package is a lightweight CLI tool designed specifically for CI/CD environments where you only need to upload dbt artifacts to Recce Cloud. It has minimal dependencies and installs faster than the full recce package.

Getting Started

You can launch Recce in any dbt project in just two commands:

# cd into your dbt project
pip install -U recce
recce server

This starts Recce locally, where you can explore lineage and run queries. To unlock the full set of diffing tools, such as data comparisons and impact checks, you'll need to prepare two environments to compare against. You can follow our Getting Started and 5-minute Jaffle Shop tutorial to try it out step-by-step.

What You Get

Recce gives you a clear, fast way to understand what your data changes are doing and why they matter. It helps you catch problems early, verify metrics, and share your findings with others, all as part of your normal workflow.

readme

Model and column level diff

Checklist for collaboration

Using Recce for Impact Assessment in dbt PR Review

  • Select nodes in the lineage to perform Checks (diffs) as part of your impact assessment during development or PR review.
  • Add Checks to your Checklist to note observed impacts.
  • Share your Checklist with the PR reviewer.
  • (Recce Cloud) Automatically sync Check status between Recce Instances
  • (Recce Cloud) Block PR merging until all Recce Checks have been approved

Read more about using Recce on our blog.

What’s Included

  • Lineage and impact mapping: Quickly see which models and columns are affected by a change. Navigate lineage down to the column level, and spot breaking changes with clear visual cues.
  • Metric and data comparisons: Use Profile, Value, Top-K, and Histogram Diffs to compare results before and after changes. Validate things like row counts, category distributions, and numeric ranges without writing extra SQL.
  • Query diff: Write and compare any two queries side by side. This is helpful when validating fixes or reviewing changes with teammates.
  • Checklist for reviews and approvals: Turn your validation steps into a checklist. Add notes, rerun checks, and share the results with reviewers or stakeholders. In Recce Cloud, checklists can sync automatically and even block PRs until checks are approved.
  • Secure by design: Recce is SOC 2 compliant to meet enterprise security standards. It runs locally or in your private environment, and your data stays in your warehouse.

👉 Want to dive deeper? Check out the full documentation.

Recce Cloud

Ready to collaborate and move faster as a team? Recce Cloud adds real-time collaboration, automatic checklist sync, and PR gating, so nothing gets merged without a full review.

  • Share checklists across environments
  • Invite stakeholders to review data changes
  • Block merges until all Checks are approved
  • Launch demo links from your CI with full context

Recce Cloud is a hosted version of Recce that standardizes your workflow, keeps teams aligned, and reduces errors—so you can ship data changes with confidence. 👉 View Pricing and Plans

Community & Support

Here's where you can get in touch with the Recce team and find support, add a subscribe to our newsletter option as well:

If you believe you have found a bug on our open source, or there is some missing functionality in Recce, please open a GitHub Issue.

Recce on the web

You can follow along with news about Recce and blogs from our team in the following places:

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

recce_cloud_nightly-1.27.0.20251127.tar.gz (35.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

recce_cloud_nightly-1.27.0.20251127-py3-none-any.whl (28.1 kB view details)

Uploaded Python 3

File details

Details for the file recce_cloud_nightly-1.27.0.20251127.tar.gz.

File metadata

File hashes

Hashes for recce_cloud_nightly-1.27.0.20251127.tar.gz
Algorithm Hash digest
SHA256 4897bf0c3379c10048d82f5a60d8648bd21bc153bb65ca58cf5f4088ff34644d
MD5 0aa3bf57e93512c3a824339f000a578f
BLAKE2b-256 71249400cf5ba0dbaa8bb28ffe2f69d82f741d5d2de60b4c5316cbb03878d983

See more details on using hashes here.

File details

Details for the file recce_cloud_nightly-1.27.0.20251127-py3-none-any.whl.

File metadata

File hashes

Hashes for recce_cloud_nightly-1.27.0.20251127-py3-none-any.whl
Algorithm Hash digest
SHA256 0dfdb910e09b22dda94fece0a605e4abff01f044f39fc890f79e9731aba388e4
MD5 d6d2e9b4b0328bf39a2a61e09ccf3f48
BLAKE2b-256 c2f37ef06fca3994a9582f7f1f83f9a55f5311b995f16bfe4b5f5869b991602b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page