---
id: dowhy
version: "0.14"
license: MIT
license_treatment: permissive
maintenance: active
---

# dowhy — DoWhy is a Python library for causal inference that supports explicit modeling and testing of causal assumptions

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

## What it is and what it does

DoWhy is a causal inference library that helps you move beyond predictive modeling to understand cause-and-effect relationships in your data. It combines two major frameworks—graphical causal models and potential outcomes—to provide a unified interface for answering causal questions: identifying whether a causal effect is estimable from your data, computing average or conditional treatment effects, performing mediation analysis, and attributing observed outcomes to their causes.

The library supports effect estimation (using instrumental variables, propensity score methods, and other techniques), root cause analysis (finding what caused an anomaly or change in distribution), what-if simulation (generating counterfactual samples), and refutation testing (validating whether your causal assumptions hold). It's designed for practitioners who need to move beyond correlation and make decisions based on causal reasoning, with built-in diagnostics to test assumptions and make inference more robust.

Use it for:

- Estimate the causal effect of a business intervention (e.g., loyalty program, pricing change) on customer behavior or revenue.
- Diagnose root causes of system failures or performance degradation in production environments.
- Quantify the direct vs. indirect effects of a treatment using mediation analysis.
- Generate counterfactual predictions to answer 'what would have happened if' scenarios for decision support.
- Validate causal assumptions and refute alternative explanations for observed effects in observational data.
- Attribute anomalies or changes in metrics to specific variables in complex systems.

## Worth the install?

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

DoWhy is a Python library for causal inference that identifies and estimates causal effects, performs root cause analysis, and answers what-if questions using graphical causal models and potential outcomes frameworks.

Yes. DoWhy is actively maintained, well-documented, has no known vulnerabilities, and is backed by a strong community. Install it if you work with observational data and need to move beyond correlation to causal reasoning—whether for effect estimation, root cause analysis, or counterfactual reasoning. The permissive MIT license removes legal friction. The main consideration is the substantial dependency footprint (13 runtime packages), which is typical for scientific Python but worth checking if you're in a constrained environment.

## Install

pip install dowhy
uv add dowhy
poetry add dowhy

## Installing dowhy

Before you install: Installation is straightforward with low friction; the package is actively maintained with recent releases and a large community (8265 GitHub stars). It requires 13 runtime dependencies including scientific computing staples like numpy, pandas, and scikit-learn, which are typically already present in data science environments.

License in practice: MIT license is permissive, allowing commercial and private use without restriction, making this suitable for most professional and academic projects.

Quickstart:

pip install dowhy

from dowhy import CausalModel
import pandas as pd

# Define causal graph and data
model = CausalModel(
    data=df,
    treatment='treatment_var',
    outcome='outcome_var',
    common_causes=['confounder1', 'confounder2'],
    instruments=['instrument_var']
)

# Identify and estimate causal effect
identified_estimand = model.identify_effect()
estimate = model.estimate_effect(identified_estimand)

Requires Python 3.9 or later; graphviz and pygraphviz are optional but recommended for visualization of causal graphs.

Verify before relying:

- Whether the package's 13 runtime dependencies can be installed without compilation issues on all target platforms.
- Performance characteristics when working with large datasets or complex causal graphs.
- Maturity level of specific estimation methods (library is marked Beta in classifiers).

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 264.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

causal inference python, effect estimation library, root cause analysis, causal discovery, counterfactual analysis, graphical causal models, treatment effect estimation, what-if analysis, causal-inference, observational-data, effect-estimation

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