Antecedent

Antecedent is an identification-first causal inference engine for Python (with a native Rust core). It takes an analysis from causal structure through estimation, diagnostics, interventions, and counterfactuals — without silently treating discovered graphs as ground truth.

Use it when you need a causal effect you can defend: identification is checked before anything is estimated, refuters run against the estimate by default, and uncertainty about the causal graph — a CPDAG, a PAG, a posterior over graphs — is carried through to the effect instead of being resolved by fiat.

Requires CPython 3.11–3.14. Install from PyPI:

pip install antecedent

Paste this block and run it. It simulates a confounded dataset, checks that the effect is identified, estimates it, and runs refuters against the estimate:

import numpy as np
from antecedent import AverageEffect, analyze

rng = np.random.default_rng(0)
n = 2000
season = rng.normal(size=n)                               # confounder
price = 0.7 * season + rng.normal(size=n)                 # treatment
sales = 1.5 * price + 2.0 * season + rng.normal(size=n)   # outcome, true effect = 1.5

result = analyze(
    data={"season": season, "price": price, "sales": sales},
    graph=[("season", "price"), ("season", "sales"), ("price", "sales")],
    query=AverageEffect(treatment="price", outcome="sales"),
)

print(result.identification)   # NonparametricallyIdentified via backdoor.adjustment, adjusting for season
print(result.estimate)         # ate=1.48, analytic and bootstrap standard errors
print(result.validation)       # refuters ran and passed

The same analyze() call scales from this to temporal dose × horizon ResponseCurve surfaces, pulse and sustained contrasts, Bayesian graph-posterior mixtures that report unidentified structure mass, mediation, counterfactuals, and root-cause attribution — see the project README for worked examples and the documentation for the full API.

Development

For local development you need a Rust 1.85 toolchain. CI builds and smoke-tests wheels for the supported CPython range on Linux x86_64/aarch64 (manylinux), macOS arm64, and Windows x86_64 (default faer path; no system BLAS). Tagged releases publish wheels to PyPI and GitHub Release assets (see docs/development.md).

cd python
uv venv && source .venv/bin/activate
uv sync --group dev
maturin develop
pytest

Lint and types (local gate only — not part of wheel CI):

bash ../scripts/gate_python_lint.sh   # ruff check/format + mypy

Public API

Primary entry point is the OO facade:

import antecedent

g = antecedent.Dag.from_edges(["z", "t", "y"], [("z", "t"), ("z", "y"), ("t", "y")])
result = antecedent.analyze(
    data,  # dict[str, array] or pandas DataFrame
    graph=g,  # or an edge list
    query=antecedent.AverageEffect(treatment="t", outcome="y"),
    inference=antecedent.Frequentist(),  # or antecedent.Bayesian(...)
)
print(result.identification, result.estimate, result.validation)

# Identify without estimating:
id_only = antecedent.identify(
    graph=g,
    query=antecedent.AverageEffect(treatment="t", outcome="y"),
    identifier=antecedent.Identifier.BACKDOOR_ADJUSTMENT,
)

gcm = antecedent.model.fit_gcm(["z", "t", "y"], columns, list(g.edges()))
draws = gcm.sample_do({"t": 1.0}, n=200)

# Or discover then fit (never invents orientations; refuses incomplete PAG/FCI):
fitted, edges = antecedent.gcm.fit_gcm_discovered(
    data, discovery=antecedent.discovery.PC(alpha=0.05)
)

The root namespace remains frozen at 49 names. Temporal response attachments and 1.3 staged kinds reuse existing query types without adding root exports. Everything else is reached through a stage module (antecedent.discovery, antecedent.priors, antecedent.errors, …).

Also exposed:

Typed graphs: Dag / Cpdag / Pag / Admg / TemporalDag (d_separated / latent_project on Dag; m_separated on Admg / Pag)
Identifier / Estimator enums (wire ids) plus string kwargs
identify(graph=…, query=AverageEffect(…)) — identify without estimating
Queries: AverageEffect, MediationEffect, Counterfactual, PulseEffect, SustainedEffect, InterventionalDistribution, PathSpecificEffect, ConditionalEffect, TemporalMediationEffect, InterventionResponse, plus the response family (ResponseCurve, AverageDerivative, PointDerivative, Elasticity, SemiElasticity, DirectionalDerivative, ResponseJacobian). Temporal dose × horizon uses the same ResponseCurve / InterventionResponse types with keyword-only horizons, policy, and treatment_lag (see examples/python/temporal_response_curve.py).
antecedent.discovery — PC, GES, LiNGAM, NOTEARS, FCI/RFCI, PCMCI family, Bayesian posteriors
antecedent.validation.validate_pcmci_* — discovery stability (block bootstrap, FPR, grids, …)
antecedent.model / antecedent.counterfactual — FittedGcm, sample_do, counterfactual_ite
antecedent.population — PopulationRegistry / target_* for named predicates and custom-distribution IPW
antecedent.gcm — fit_gcm_discovered / attribute_*_discovered discover-then-attribute composition
antecedent.state.CausalState — incremental state with retained batches, events, suff-stats, particle filter
refute="full"|"placebo"|False on static analyze (refute=True is a TypeError; leave it unset for the licensed default). Static and temporal ResponseCurve / InterventionResponse license validation none only; requesting a scalar refuter suite raises CausalUnsupportedError.
RD: estimator="rd.sharp" with running_variable / cutoff / bandwidth
Graph interchange on the classes: Dag.from_dot / .to_dot and the JSON / GML / NetworkX peers
Design / state examples: examples/python/rank_designs.py, examples/python/causal_state_workflow.py, examples/python/temporal_response_curve.py, examples/python/staged_static_kinds.py (see ADR 0016 — no auto-rerun); catalog in examples/README.md

Build artifacts (_native.*.so) are gitignored; always maturin develop (or install a wheel) on a fresh checkout.

In 1.3, antecedent.estimation.PreparedAnalysis also stages Frequentist DAG derivatives, static natural mediation, explicit-DAG unit counterfactuals, and the published observation-pair contract (selected AIPW, marginal KM, conditional Cox IPCW). Derivative cheap/full stay n/a; counterfactual sampling uncertainty is unavailable. See the 1.3 evidence ledger and the 1.2 ledger below for earlier Bayesian and sequential forms.

In 1.2, antecedent.estimation.PreparedAnalysis also supports the licensed Bayesian conditional, temporal-mediation and response forms, and multi-step SustainedEffect(..., window=(-2, -1)). Choose the validation suite when preparing these analyses; second-click refute() remains AverageEffect-only. export_artifact() retains the fitted posterior or response, while export_artifact(payload="query") retains the original query kind and variable IDs. Scalar posterior exports do not include the complete assumption or validation ledger; retain the analysis result alongside them. See the 1.2 evidence ledger for model restrictions and evidence.

Typed exceptions (CausalError and subclasses) mirror Rust CausalError categories. The native module antecedent._native remains available for advanced FFI use (including the flat AteAnalysisResult DTO; prefer nested AnalysisResult).

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

antecedent-1.3.0-cp314-cp314-win_amd64.whl (6.7 MB view details)

Uploaded Sep 9, 2026 CPython 3.14Windows x86-64

antecedent-1.3.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (7.2 MB view details)

Uploaded Sep 9, 2026 CPython 3.14manylinux: glibc 2.17+ x86-64

antecedent-1.3.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (6.6 MB view details)

Uploaded Sep 9, 2026 CPython 3.14manylinux: glibc 2.17+ ARM64

antecedent-1.3.0-cp314-cp314-macosx_11_0_arm64.whl (6.1 MB view details)

Uploaded Sep 9, 2026 CPython 3.14macOS 11.0+ ARM64

antecedent-1.3.0-cp313-cp313-win_amd64.whl (6.8 MB view details)

Uploaded Sep 9, 2026 CPython 3.13Windows x86-64

antecedent-1.3.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (7.2 MB view details)

Uploaded Sep 9, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

antecedent-1.3.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (6.6 MB view details)

Uploaded Sep 9, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64

antecedent-1.3.0-cp313-cp313-macosx_11_0_arm64.whl (6.1 MB view details)

Uploaded Sep 9, 2026 CPython 3.13macOS 11.0+ ARM64

antecedent-1.3.0-cp312-cp312-win_amd64.whl (6.8 MB view details)

Uploaded Sep 9, 2026 CPython 3.12Windows x86-64

antecedent-1.3.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (7.2 MB view details)

Uploaded Sep 9, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

antecedent-1.3.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (6.6 MB view details)

Uploaded Sep 9, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64

antecedent-1.3.0-cp312-cp312-macosx_11_0_arm64.whl (6.1 MB view details)

Uploaded Sep 9, 2026 CPython 3.12macOS 11.0+ ARM64

antecedent-1.3.0-cp311-cp311-win_amd64.whl (6.8 MB view details)

Uploaded Sep 9, 2026 CPython 3.11Windows x86-64

antecedent-1.3.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (7.2 MB view details)

Uploaded Sep 9, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

antecedent-1.3.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (6.6 MB view details)

Uploaded Sep 9, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64

antecedent-1.3.0-cp311-cp311-macosx_11_0_arm64.whl (6.2 MB view details)

Uploaded Sep 9, 2026 CPython 3.11macOS 11.0+ ARM64

File details

Details for the file antecedent-1.3.0-cp314-cp314-win_amd64.whl.

File metadata

Download URL: antecedent-1.3.0-cp314-cp314-win_amd64.whl
Upload date: Sep 9, 2026
Size: 6.7 MB
Tags: CPython 3.14, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.11 {"installer":{"name":"uv","version":"0.12.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for antecedent-1.3.0-cp314-cp314-win_amd64.whl
Algorithm	Hash digest
SHA256	`c4e0217c3be2c92d43320e0751c24ff9c2553f5a71686a57187ebe29611aff26`
MD5	`58948abbf9cc2915afcb36f5922c4cd7`
BLAKE2b-256	`4e48c94d5300c4ad48eb4ef79da18609a9f822e6a4cb14032320fbd1ed957ea7`

Algorithm	Hash digest
SHA256	`dd2f344533601a580d8779ef4b8e84fe05f5e9f970ba8719f0aa91611cc55606`
MD5	`2a5f93d9206b47c1d5a1325f87f99f8b`
BLAKE2b-256	`ed0b1879c4c337d78d491a64a5d06cfffea6080dfc86af805297b0700868c121`

Algorithm	Hash digest
SHA256	`af52ba785affa6324bdd5bed4e41a972b3e1b0c2efe9db59debe0110165dce05`
MD5	`1a91473a6683fa097cdddf70cd9d7625`
BLAKE2b-256	`74d288f8ffb9d583df4deba837b5582ffc5370959b181f39b93295ffdcc6e834`

Algorithm	Hash digest
SHA256	`91b901ed3e2e2ea7a848951a875268b87026f0c015a4b396ae849a6230c20a54`
MD5	`3d2a204c3a64a7ae34008d9d34915291`
BLAKE2b-256	`104ef5b4e874485afc9ede250b657e9162409d84f41480025ae1f4a112dab80e`

Algorithm	Hash digest
SHA256	`34ebe85435a511f303586c53b56d7c9644917667cff0dcf3edb921a3f2516650`
MD5	`7070fe5a7b532a6cfbcd80ca3e859e3a`
BLAKE2b-256	`1c6f20a57a9cbfdd25fcdb5e67180ad42ab01f2c3bc125d0ddf6596001b748bd`

Algorithm	Hash digest
SHA256	`2b9b889cee2a43c2a3dd7333145eda03c4df0696e7c8fccd8cb5071a26f16f79`
MD5	`4996a6bc12357579099831c527de920a`
BLAKE2b-256	`d90c1c9a32c2336a6200ab4f0af6b3adbe751e10511460e32c9b31b43cda9429`

Algorithm	Hash digest
SHA256	`4414f692d468c132d87548a2053f54ef0813806f99fb977074e0f0b459f0330c`
MD5	`327c02b363ed5ac2eebf8ed5a8233ba2`
BLAKE2b-256	`f5484d464f32f5a58aeba9a4ec90cad1ae0eb9670f8dc083731a08ecc59de228`

Algorithm	Hash digest
SHA256	`d764289c70172525cd552a455fef91c60a9b4bb5bdb65a116fdacd83bd285323`
MD5	`344d6d906a80ed61007ca240823578d3`
BLAKE2b-256	`28b4a127871b5c35cff7c6e5dbe0c18b8169014a75f5c7bb4c717a8ba5da485c`

Algorithm	Hash digest
SHA256	`5d4ce664a05f6aa0e2b668f54fe26e2436ea9deef5b55cd9892c411f2079facd`
MD5	`ac6532acad1f2e1ff757fb91df37d9d0`
BLAKE2b-256	`5b9e6b9f850be1fc54aa447aed9ef6c081998e3f7a33acc678b54b93c6f4b4b0`

Algorithm	Hash digest
SHA256	`4b6101cf879d9588980507ea6174f65671b6613ba71dc0691ecd86f889f83b6d`
MD5	`ccb27208dbd25abb2f11a4a40dad97b9`
BLAKE2b-256	`c5531655bce6610dbd5f098689b8803370982d0f03c15937e07d73c303442acb`

Algorithm	Hash digest
SHA256	`83bd6e3b8b0f3c08e0623846eff67bd3d9f4b58ceb4bd44504158ce36d47ee10`
MD5	`45f1a18fc699cf077213cfe9c40821d7`
BLAKE2b-256	`e7f98571d60a52cd4bc438dea7683d1fb965bbdeb6ff9f3747b513113f2cfc1c`

Algorithm	Hash digest
SHA256	`b3ddfa65eb9ac59a11dd17973ec7543f559ef7eb8e2f0f16293a7d9518ee2d3a`
MD5	`9e058bbd4cc50775d81cf2aec03db41d`
BLAKE2b-256	`ff739ee1798d8b3abbcbf48d95c8b29202e1b2c080cf5fcb4944c4700c2be484`

Algorithm	Hash digest
SHA256	`4581dd4b6a0b9542da5711339153306b1ec63a4143686ead030bca41839110f8`
MD5	`2f638b16c3d57c6f992370efc570d794`
BLAKE2b-256	`3bc272d9e39e9947f47af49faa7f73edbc92ea0f948dedf9580a02f7b9cf1283`

Algorithm	Hash digest
SHA256	`9ab7ef8d9b5db4d9ad40380d4d7bee4a3dfa70965c03a5877ca55d9d09448f26`
MD5	`1eaaed472c6121f7ab4ac56c269da015`
BLAKE2b-256	`ee28fca752a33f205cfdbbd9dbf09e72419de971f8fda4ec076b0d990529ec20`

Algorithm	Hash digest
SHA256	`d41e39a5b21b1fe882b92e8d6d3ebfdbfd3a2b6aa853212fc6493592152dbd3b`
MD5	`637d6d419624019dabb168fe9e90459a`
BLAKE2b-256	`71400adc0ba4c418045df9279f9d3925df6783215edb3b33b0477b111b6d1f1f`

Algorithm	Hash digest
SHA256	`f2169ff2069603fc7a41b7f31efafe9a72fa8653a3295e37ebc9eadc0eab19e5`
MD5	`261db5693046430cc2cd6e05f35d3e94`
BLAKE2b-256	`f3fdbd9e4a8643076a08f9fa313313b6be8e852baee935eec8e3b0fe83310f25`

antecedent 1.3.0

Antecedent

Development

Public API

Project links

Key dates

1 maintainer

GitHub Statistics

License

Requires

Classifiers

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

Release history Release notifications | RSS feed