AkahuSync

This is my attempt to use NZ's open banking, along with some web scraping, to try and make sense of my financial position over time
My intention is to gather daily, weekly, and monthly snapshots of my networth, to the end that some visibilty will help steer me in the right direction
I also have some enhancements planned, such as writing transactional data to Firefly, where I will categorize and report on purchases

make sure to install playwright (pip install playwright), then run:

playwright install --with-deps

to get the correct drivers and dependencies for the host system

Runtime flags

These env vars let you split Akahu vs Emoney runs (useful for separate k8s cron jobs):

• RUN_AKAHU (default true)
• RUN_EMONEY (default true)
• RUN_NORMALIZE (default true)

Example:

RUN_AKAHU=true RUN_EMONEY=false RUN_NORMALIZE=true python main.py

Container notes

• The Docker image uses Playwright's Python base image.
• The Emoney scraper runs headless by default.

Normalization gotchas

• Akahu org is derived from the connection name (BNZ/Sharesies), not the source name.
• Emoney transactions are hardcoded to vendor "Finance Now".
• Akahu descriptions with "INTERNET XFR" are rewritten to include the counterparty info and meta fields.