PolicyEngine US
For microsimulation, use policyengine.py. Society-wide microsimulation — population aggregates and distributional or budgetary impacts — is moving to the managed
policyengine.pybundle, which pins certified, calibration-gated datasets. Direct microsimulation viapolicyengine-us(Microsimulation()) is deprecated and being migrated topolicyengine.py. This package remains the home of the US tax-benefit rules and household-level calculations. Microsimulation results are estimates — inspect dataset calibration at https://calibration-diagnostics.vercel.app/populace.
PolicyEngine US is a microsimulation model of the US state and federal tax and benefit system.
PolicyEngine US supports Python 3.11 through 3.14 and requires pandas 3 or
later. To install, run pip install policyengine-us.
This release requires spm-calculator>=1.0.0,<=1.0.0.post1 (the canonical SPM threshold API).
Previously published country versions retain their original dependency metadata;
when reproducing one of those versions, include the compatible calculator
explicitly, for example:
uv pip install "policyengine-us==1.824.7" "spm-calculator==0.3.1"
To install PolicyEngine US as part of a certified PolicyEngine bundle, use the
bundle installer published by policyengine, for example:
uvx --from policyengine policyengine bundle install --country us --venv .venv
Statutes, forms and agency practice
When a statute conflicts with a regulation, form, instructions, manual or
stated agency practice, PolicyEngine US's rule is to follow the statute.
Forms and instructions fill gaps where the statute is silent. Each such
conflict is recorded in the source-conflict register that PolicyEngine shares
with the Axiom Foundation, including any code that does not follow the rule
yet: known-source-conflicts.yaml in
TheAxiomFoundation/rulespec-us.
For each conflict it gives what each source says, a worked example, the
reading this model takes and why, and the code and tests that implement it.
The code marks the deciding line with # Source conflict <jurisdiction>:<id>. See
CONTRIBUTING.md.
1 maintainer
Metadata
1 maintainer
Release files for policyengine-us 2.58.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| policyengine_us-2.58.1.tar.gz | 14.7 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| policyengine_us-2.58.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 33.4 MB
Release files / policyengine_us-2.58.1.tar.gz
| Download URL | policyengine_us-2.58.1.tar.gz |
|---|---|
| Size | 14.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
84dac2c4a3d52ec1602d48e8849aa9afa802986a8535586952228a69968d778d
|
|
BLAKE2b-256 checksum How to use checksums |
81157ab2fc836e30f1cd85766365f249f82f768d7eae6453f336f672c6bfb360
|
| 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 Oct 22, 2026.
Transparency logRelease files / policyengine_us-2.58.1-py3-none-any.whl
| Download URL | policyengine_us-2.58.1-py3-none-any.whl |
|---|---|
| Size | 18.8 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
57e24e2a30f18cb3d29e6bc34963e73c0734b69d5798ca6daefaef72ab419ec8
|
|
BLAKE2b-256 checksum How to use checksums |
5b6d62da1f82a72af82c88abb6e845a0a55e4579fca1cceabde6aec37011a96a
|
| 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 Oct 22, 2026.
Transparency logSecurity for policyengine-us 2.58.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 2 files in this release have been uploaded with provenance metadata.
Attestation for policyengine_us-2.58.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 Oct 22, 2026.
Transparency logA 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.
