Federal Individual Income Tax Microsimulation Model
Python Tcl Other
Latest commit dcd8216 Mar 25, 2017 @martinholmer martinholmer committed on GitHub Merge pull request #1262 from martinholmer/master
Remove unneeded pylint-disable comments
Failed to load latest commit information.
conda.recipe Revise meta.yaml to test CLI entry point Mar 20, 2017
continuous_integration Remove external dependencies in AppVeyor scripts Dec 29, 2016
distribution Revise meta.yaml to test CLI entry point Mar 20, 2017
docs correct list numbering in contributor guide Mar 13, 2017
file-upload-tests Eliminate 'standar' assumption terminology Mar 21, 2017
taxcalc Remove unneeded pylint-disable comments Mar 25, 2017
.coveragerc Generalize taxcalcio.py logic Mar 20, 2017
.gitattributes add versioning with versioneer Jan 30, 2015
.gitignore Update .gitignore with *.DS_Store Aug 30, 2016
.travis.yml Python version from Travis environment Dec 10, 2016
CODING.md Add more text to CODING.md file. Oct 18, 2016
DATAPREP.md Update documentation wrt new dropq tests. Nov 6, 2016
LICENSE.md Update LICENSE.md Oct 15, 2015
MANIFEST.in .csv to growdiff.json Mar 6, 2017
ODD_RECORDS.md Update documentation wrt new dropq tests. Nov 6, 2016
README.md Revise README.md to link to new CODING.md documentation. Oct 11, 2016
TESTING.md Describe how to update puf.csv in the TESTING.md file. Jan 18, 2017
appveyor.yml upgrade appveyor conda to 4.2.13 Dec 31, 2016
environment.yml no need to add mock to environment.yml - it was already there Feb 6, 2017
readthedocs.yml Add YAML file for readtheodcs Mar 1, 2016
setup.cfg update setup.cfg to fix pytest deprec warning Dec 31, 2016
setup.py Add taxcalc.cli to packages list in setup.py Mar 20, 2017
versioneer.py resolve E226, E241, E121 Aug 10, 2015


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 simtax.py command-line interface to Tax-Calculator. And you can also process your own CSV-formatted data using the inctax.py 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.