calcfi-compound-interest 0.1.0

Compound interest with periodic contributions. Future value, present value, time-to-target. Free, MIT.

calcfi-compound-interest

Compound interest with periodic contributions. Future value, present value, time-to-target. Free, MIT.

CalcFi Compound Interest Calculator — a single-purpose, MIT-licensed helper for Compute future value of regular contributions at compound rate (FV = PMT × [(1+r)^n − 1] / r), plus present value, time-to-target, and per-decade contribution breakdowns.

What this does

Compute future value of regular contributions at compound rate (FV = PMT × [(1+r)^n − 1] / r), plus present value, time-to-target, and per-decade contribution breakdowns.

Formula — Future value with regular contributions:

FV = PMT × [(1+r)^n − 1] / r

Primary source: Standard textbook compound interest formula

Install

pip install calcfi-compound-interest

Usage

from calcfi_compound_interest import future_value

# $500/month at 8% for 30 years
fv = future_value(500, 0.08, 30)
# ~745,180

Live calculator

Try the interactive web calculator with full UI at https://calcfi.app/calculators/compound-interest — no signup required.

Why this package exists

Most personal-finance calculators are buried in advertising-heavy lead-generation sites. The math is freely published by federal agencies and textbooks, but the implementations are wrapped in proprietary opaque code. CalcFi publishes these utility libraries to make every formula:

1. Reproducible — show the math
2. Cited — link to primary sources
3. Free — MIT license, no paid tier
4. Auditable — every line of code is open source

The math here is undergraduate-level. The contribution is the citation discipline and the open distribution.

Part of the CalcFi ecosystem

This package is one of 8 single-purpose helper utilities. Cross-mesh:

Sibling Python packages

• calcfi-mortgage-payment — Standard amortizing-loan monthly payment formula. Free, cited, MIT.
• calcfi-rule-of-72 — Rule of 72 — approximate years to double an investment at a given rate. Plus exact ln(2) version. MIT.
• calcfi-apr-apy — Convert between APR (simple annual rate) and APY (effective annual yield including compounding). MIT.
• calcfi-real-return — Inflation-adjusted (real) return from nominal return. Formula: real = (1+nominal)/(1+inflation) − 1. MIT.
• calcfi-amortization — Generate a full amortization schedule for a fixed-rate loan: payment, principal, interest, balance per period. MIT.
• calcfi-tax-bracket — US federal income tax bracket math — marginal rate, effective rate, total tax owed. 2024-2026 brackets per IRS Rev. Proc. MIT.
• calcfi-debt-payoff — Snowball vs avalanche debt payoff strategies. Compute months and total interest. MIT.

Sibling npm packages

• calcfi-mortgage-payment — Standard amortizing-loan monthly payment formula. Free, cited, MIT.
• calcfi-rule-of-72 — Rule of 72 — approximate years to double an investment at a given rate. Plus exact ln(2) version. MIT.
• calcfi-apr-apy — Convert between APR (simple annual rate) and APY (effective annual yield including compounding). MIT.
• calcfi-real-return — Inflation-adjusted (real) return from nominal return. Formula: real = (1+nominal)/(1+inflation) − 1. MIT.
• calcfi-amortization — Generate a full amortization schedule for a fixed-rate loan: payment, principal, interest, balance per period. MIT.
• calcfi-tax-bracket — US federal income tax bracket math — marginal rate, effective rate, total tax owed. 2024-2026 brackets per IRS Rev. Proc. MIT.
• calcfi-debt-payoff — Snowball vs avalanche debt payoff strategies. Compute months and total interest. MIT.

Companion data

The mortgage rate, inflation, Treasury yield, and macro data used to validate these calculators are published as CalcFi Open Data — 34 free CC BY 4.0 time series, 117,956 observations, 5 permanent DOIs.

• CalcFi Open Data on Hugging Face
• Python calcfidata SDK
• npm calcfidata SDK
• Live SQL endpoint (Datasette)
• DOI 10.6084/m9.figshare.32332290

Calculators on CalcFi (free, no signup)

Every formula in these packages has a live web calculator at calcfi.app:

• Mortgage Payment
• Compound Interest
• Tax Bracket
• Amortization Schedule
• APR vs APY
• Rule of 72
• Inflation-Adjusted Return
• Debt Payoff

License

MIT. Author: Jere Salmisto (ORCID 0009-0000-0916-8684), founder of CalcFi. Based in Helsinki, Finland.

Citation

If you cite this package in research:

Salmisto, J. (2026). calcfi-compound-interest: CalcFi Compound Interest Calculator.
DOI: 10.6084/m9.figshare.32332290 (parent CalcFi Open Data dataset).
Available: https://calcfi.app/calculators/compound-interest

Or use the CITATION.cff on the parent dataset for the BibTeX entry.