mint-sankey is a tool that will take your Mint transactions, combine it with your paycheck info, and dump text data out so that SankeyMatic can read it.
You can see an example input file in data/test-data.csv, which will generate output like so:
Wages [197] Federal Income Tax
Wages [32] Social Security
Wages [755] Take Home
Take Home [105] Hotel
Take Home [35] Income
Take Home [32] Restaurants
Take Home [24] Groceries
Take Home [24] Gas & Fuel
Take Home [535] Savings
You can then copy-paste this away into SankeyMatic and get the following plot:
There's also a flag in the config to use_percentages, which will output relative, not absolute values. It's a little buggy as I go back and forth on whether or not I want to noramlize by level or to the "global" input. Maybe it'll help you!
Using the tool requires Python 3.6 or higher.
Go to Mint and download your transaction history to the data/ folder. The default name used is transactions.csv.
Clone the repo and install the requirements:
pip install -r requirements.txt
Copy config-sample.toml to config.toml and edit away.
Run the tool with python sankey_gen.py. The default output file is output.txt. Copy the contents of that file into SankeyMatic and enjoy!
I use:
yapffor formattingflake8for lintingpyrefor type checking
In general, I try to be yapf and flake8 issue free, and minimize as many errors as possible from pyre. Once the errors start showing up as a result of other (pip-installed) modules, I punt on them. To use these, run:
pip install -r requirements-dev.txt
pyre init
Do what you want, see LICENSE.md
- nowthis for creating SankeyMatic tool