Metadata-Version: 2.4
Name: retirecan
Version: 0.1.4
Summary: A flexible retirement planning and portfolio simulation engine for Canadians
Author-email: Hwimin Park <hwiminp@student.ubc.ca>, Rex Tseng <pkstudy35@gmail.com>, Sage Yang <sage1919@student.ubc.ca>
License: MIT
Project-URL: Homepage, https://github.com/hwiminPark/533-Project-Group-13
Project-URL: Repository, https://github.com/hwiminPark/533-Project-Group-13
Project-URL: Issues, https://github.com/hwiminPark/533-Project-Group-13/issues
Keywords: retirement,finance,monte-carlo,simulation
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Financial and Insurance Industry
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# RetireCan – Canadian Retirement Planner & Optimizer

**RetireCan** tells you — in under 10 seconds — the single best way to save and withdraw money in Canada so you pay the least tax and die with the most money.

It automatically compares all realistic RRSP/TFSA/Non-registered contribution and withdrawal strategies and shows you the optimal one for your exact numbers.

## Features

- Interactive mode – just answer a few questions
- Tests every meaningful strategy combination (TFSA-first vs RRSP-first, spend taxable first, spend RRSP first, smooth withdrawals, etc.)
- Realistic Canadian tax treatment (RRSP deductions, TFSA tax-free growth/withdrawals, capital gains, dividend tax credits, OAS clawback aware)
- CPP and OAS integration
- Beautiful wealth-over-time chart
- 100% open source and zero dependencies beyond numpy/pandas/matplotlib

## Quick Start (30 seconds)

```bash
pip install retirecan
python -m retirecan
```
