Mint Sankey

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!

Getting Started

Prerequisites

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.

Installing

Clone the repo and install the requirements:

pip install -r requirements.txt

Copy config-sample.toml to config.toml and edit away.

Running

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!

Style & Formatting

I use:

• yapf for formatting
• flake8 for linting
• pyre for 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

License

Do what you want, see LICENSE.md

Acknowledgements

• nowthis for creating SankeyMatic tool