Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!


Project description

[![Travis-CI Build Status](]( [![Codecov Status](](


Tax-Calculator simulates the US federal individual income tax system. In conjunction with micro data that represent the US population and a set of behavioral assumptions, Tax-Calculator can be used to conduct revenue scoring and distributional analyses of tax policies. Tax-Calculator is written in Python, an interpreted language that can execute on Windows, Mac, or Linux.


Results will change as the underlying models improve. A fundamental reason for adopting open source methods in this project is so that people from all backgrounds can contribute to the models that our society uses to assess economic policy; when community-contributed improvements are incorporated, the model will produce different results.

Getting Started

There are two common ways to get started with Tax-Calculator:

The first way is to install the Tax-Calculator repository on your computer. Do this by following the instructions in our [Contributor Guide]( After the installation you can read the source code and either use Tax-Calculator as is or develop new Tax-Calculator capabilities.

When using Tax-Calculator on your computer you will have to supply your own input data on tax filing units because the repository does not include a representative sample of tax filing units. However, you can use it to estimate tax liabilities and marginal tax rates for any collection of filing units specified in [Internet-TAXSIM input format]( using the command-line interface to Tax-Calculator. And you can also process your own CSV-formatted data using the command-line interface to Tax-Calculator, but when doing this be sure to read the [data-preparation guidelines](

When developing new Tax-Calculator capabilities be sure to read about our [coding style]( and [testing procedures]( after you have read completely the [Contributor Guide](

The second way is to access Tax-Calculator through our web application, [TaxBrain]( This way allows you to generate aggregate and distributional tax reform estimates using a nationally representative sample of tax filing units that is not part of the Tax-Calculator repository.

And, of course, you can get started with Tax-Calculator both ways.

Project details

Download files

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

Files for taxcalc, version 0.7.82
Filename, size File type Python version Upload date Hashes
Filename, size taxcalc-0.7.82.tar.gz (7.4 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page