Responsive Flask/SQLAlchemy personal finance app, specifically for biweekly budgeting.
For full documentation, see http://biweeklybudget.readthedocs.io/en/latest/
For screenshots, see http://biweeklybudget.readthedocs.io/en/latest/screenshots.html
For development activity, see https://waffle.io/jantman/biweeklybudget
biweeklybudget is a responsive (mobile-friendly) Flask/SQLAlchemy personal finance application, specifically targeted at budgeting on a biweekly basis. This is a personal project of mine, and really only intended for my personal use. If you find it helpful, great! But this is provided as-is; I’ll happily accept pull requests if they don’t mess things up for me, but I don’t intend on working any feature requests or bug reports at this time. Sorry.
The main motivation for writing this is that I get paid every other Friday, and have for almost all of my professional life. I also essentially live paycheck-to-paycheck; what savings I have is earmarked for specific purposes, so I budget in periods identical to my pay periods. No existing financial software that I know of handles this, and many of them have thousands of Google results of people asking for it; almost everything existing budgets on calendar months. I spent many years using Google Sheets and a handful of scripts to template out budgets and reconcile transactions, but I decided it’s time to just bite the bullet and write something that isn’t a pain.
Intended Audience: This is decidedly not an end-user application. You should be familiar with Python/Flask/MySQL. If you’re going to use the automatic transaction download functionality, you should be familiar with Hashicorp Vault and how to run a reasonably secure installation of it. I personally don’t recommend running this on anything other than your own computer that you physically control, given the sensitivity of the information. I also don’t recommend making the application available to anything other than localhost, but if you do, you need to be aware of the security implications. This application is not designed to be accessible in any way to anyone other than authorized users (i.e. if you just serve it over the web, someone will get your account numbers, or worse).
This software should be considered alpha quality at best. At this point, I can’t even say that I’m 100% confident it is mathematically correct, balances are right, all scheduled transactions will show up in the right places, etc. I’m going to be testing it for my own purposes, and comparing it against my manual calculations. Until further notice, if you decide to use this, please double-check everything produced by it before relying on its output.
- Budgeting on a biweekly (fortnightly; every other week) basis, for those of us who are paid that way.
- Optional automatic downloading of transactions/statements from your financial institutions.
Note: Alternatively, biweeklybudget is also distributed as a Docker container. Using the dockerized version will eliminate all of these dependencies aside from MySQL (which you can run in another container) and Vault (if you choose to take advantage of the OFX downloading), which you can also run in another container.
- Python 2.7 or 3.3+ (currently tested with 2.7, 3.3, 3.4, 3.5, 3.6 and developed with 3.6)
- Python VirtualEnv and
pip(recommended installation method; your OS/distribution should have packages for these)
- Git, to install certain upstream dependencies.
- MySQL, or a compatible database (e.g. MariaDB). biweeklybudget uses SQLAlchemy for database abstraction, but currently specifies some MySQL-specific options, and is only tested with MySQL.
- To use the automated OFX transaction downloading functionality:
It’s recommended that you install into a virtual environment (virtualenv / venv). See the virtualenv usage documentation for information on how to create a venv.
This app is developed against Python 3.6, but should work back to 2.7. It does not support Python3 < 3.3.
Please note that, at the moment, two dependencies are installed via git in order to make use of un-merged pull requests that fix bugs; since
git clone https://github.com/jantman/biweeklybudget.git && cd biweeklybudget virtualenv --python=python3.6 . source bin/activate pip install -r requirements.txt python setup.py develop
biweeklybudget itself is licensed under the
GNU Affero General Public License, version 3.
This is specifically intended to extend to anyone who uses the software remotely
over a network, the same rights as those who download and install it locally.
biweeklybudget makes use of various third party software, especially in the UI and
frontend, that is distributed under other licenses. Please see
biweeklybudget/flaskapp/static in the source tree for further information.
- Index Page
- Pay Periods View
- Single Pay Period View
- Accounts View
- Account Details
- OFX Transactions
- Transactions View
- Transaction Detail
- Single Budget View
- Scheduled Transactions
- Specific Date Scheduled Transaction
- Monthly Scheduled Transaction
- Number Per-Period Scheduled Transactions
- Reconcile Transactions with OFX
- Drag-and-Drop Reconciling
- Getting Started
- Running With Docker
- Flask App
- OFX Transaction Downloading
- Getting Help
- biweeklybudget package
- biweeklybudget.backfill_ofx module
- biweeklybudget.biweeklypayperiod module
- biweeklybudget.cliutils module
- biweeklybudget.db module
- biweeklybudget.db_event_handlers module
- biweeklybudget.initdb module
- biweeklybudget.load_data module
- biweeklybudget.ofxgetter module
- biweeklybudget.ofxupdater module
- biweeklybudget.screenscraper module
- biweeklybudget.settings module
- biweeklybudget.settings_example module
- biweeklybudget.utils module
- biweeklybudget.version module
- biweeklybudget package