Owl is a retirement financial planning tool that uses a mixed-integer linear programming optimization algorithm to provide guidance on retirement decisions such as contributions, withdrawals, Roth conversions, and more. Users can select varying return rates to perform historical back testing, stochastic rates for performing Monte Carlo analyses, or fixed rates either derived from historical averages, or set by the user.
Owl is designed for US retirees as it considers US federal tax laws, ACA marketplace premiums (pre-65), Medicare premiums, rules for 401k including required minimum distributions, maturation rules for Roth accounts and conversions, social security rules, etc.
There are three ways to run Owl (from easiest to more complex):
-
Streamlit Hub: Run Owl remotely as hosted on the Streamlit Community Cloud at owlplanner.streamlit.app.
-
Docker Container: Run Owl locally on your computer using a Docker image. Follow these instructions for using this option.
-
Self-hosting: Run Owl locally on your computer using Python code and libraries. Follow these instructions to install from the source code and self-host on your own computer.
| Document | Description |
|---|---|
| INSTALL.md | Installation guide, Python environment setup, and developer build steps |
| USER_GUIDE.md | Python API usage with examples for Jupyter notebooks and scripts |
| PARAMETERS.md | Complete reference for TOML case file parameters |
| RATE_MODELS.md | Available rate models (historical, stochastic, bootstrap, etc.) |
| docs/modeling-capabilities.md | Summary of modeled components, assumptions, and limitations |
| papers/owl.tex | Mathematical foundations (PDF build via LaTeX) |
Documentation for the app user interface is also available from the Streamlit UI.
See CREDITS.md.
Please submit bugs and feature requests through GitHub if you have a GitHub account or directly by email. Or just drop me a line to report your experience with the tool.
This app does not store or forward any information. All data entered is lost after a session is closed. However, you can choose to download selected parts of your own data to your computer before closing the session. These data will be stored strictly on your computer and can be used to reproduce a case at a later time.
Copyright © 2024-2026 - Martin-D. Lacasse
Disclaimers: This code is for educational purposes only and does not constitute financial advice.
Code output has been verified with analytical solutions when applicable, and comparative approaches otherwise. Nevertheless, accuracy of results is not guaranteed.