estimated-taxes 2025.3

Estimated taxes calculator

estimated-taxes

Estimated taxes calculator.

This is meant to help estimate additional tax payments throughout the year, i.e. for IRS form 1040-ES and CA form 540-ES.

Please review the logic yourself if you intend to use this. It intentionally does not attempt to handle all forms and all scenarios; you will likely need to augment it for your particular needs.

See also nkouevda/capital-gains.

Installation

pip install estimated-taxes

Or:

brew install nkouevda/nkouevda/estimated-taxes

Usage

usage: estimated-taxes [<options>] [--] <input file>

Estimated taxes calculator

options:
  -h, --help     show this help message and exit
  -v, --version  show program's version number and exit

Input Format

See input/example.yaml.

The input file must start with !InputData, and must specify year, filing_status, fed_allowances, and ca_allowances. All other values are optional.

Each value must be a number, or a list of numbers, or a map where the values are numbers. Lists and maps are allowed for convenience, to split up categories into multiple entries. For example, the following are all equivalent:

supplemental_wages: 62500

supplemental_wages:
  - 12500
  - 50000

supplemental_wages:
  bonus: 12500
  rsu: 50000

Examples

estimated-taxes input/example.yaml > output/example.txt

TODO

• Itemized deductions other than SALT
• AMT

License

MIT License