---
id: dbt-state
version: "2.43.1"
license: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# dbt-state — dbt plugin that skips redundant model executions by caching results from previous runs

License: permissive · Maintenance: active · Downloads: 679.1K/mo

## What it is and what it does

dbt-state is a plugin for dbt that accelerates data transformation pipelines by caching model execution results and skipping runs that would produce identical outputs. It integrates into the dbt ecosystem and uses prior run state to determine which models need to execute, reducing redundant computation and shortening build times.

The plugin depends on dbt-core and a suite of supporting libraries including protobuf for serialization, grpcio for communication, and query-cache utilities for state management. It is actively maintained and requires Python 3.9 or later. The Apache 2.0 license permits use in commercial and proprietary projects.

Use it for:

- Accelerate CI/CD pipelines by skipping model rebuilds when upstream data hasn't changed.
- Reduce cloud data warehouse costs by avoiding redundant SQL execution on unchanged models.
- Speed up local development iteration by caching intermediate model results across dbt runs.
- Enable incremental dbt workflows where only affected downstream models are recomputed after source updates.
- Optimize scheduled dbt jobs by detecting and skipping models with no new input data.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

dbt-state is a dbt plugin that caches model execution results and skips redundant runs, reducing build time by reusing prior outputs.

Yes, if you run dbt pipelines frequently and want to reduce execution time and compute costs. The low install friction, active maintenance, permissive license, and zero known vulnerabilities make it a safe choice. Verify dbt-core compatibility and review how caching integrates with your workflow before deploying to production.

## Install

pip install dbt-state
uv add dbt-state
poetry add dbt-state

## Installing dbt-state

Before you install: Low install friction with a pure-Python wheel. Active maintenance as of 2026-08-14. Requires dbt-core and 16 runtime dependencies including protobuf, grpcio, and query-cache libraries; verify compatibility with your dbt version before installing.

License in practice: Apache License 2.0 permits commercial use, modification, and redistribution with attribution. You may use this in proprietary projects provided you include the license and document changes.

Quickstart:

pip install dbt-state

# After installation, dbt-state integrates as a dbt plugin
# and is invoked through dbt commands that reference cached state

Requires Python >=3.9.0 and dbt-core to be installed; dbt-state acts as a plugin within the dbt ecosystem, not a standalone tool.

Verify before relying:

- How dbt-state integrates with existing dbt workflows and whether it requires configuration changes to dbt_project.yml or profiles.yml.
- Whether the cache is stored locally, remotely, or both, and what storage backends are supported.
- Performance improvement metrics or benchmarks for typical dbt projects.
- Compatibility matrix with specific dbt-core versions and whether breaking changes exist between releases.

## Package facts

- License: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 679.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

dbt caching plugin, skip redundant dbt models, dbt execution cache, dbt state management, dbt build optimization, dbt result caching, dbt performance tuning, dbt-plugin, data-pipeline-optimization, caching

[View on SkillFed](https://skillfed.io/packages/dbt-state) · [View on PyPI](https://pypi.org/project/dbt-state/)