fintl 0.1.0

Financial ETL CLI: parse, normalize, and explore your bank transaction data.

fintl

Financial ETL CLI: parse, normalize, and explore your bank transaction data.

TL;DR

This tool helps you process, visualize and search your balance and transaction information that you have exported from your bank accounts.

Currently supports DKB, Postbank, GLS and Scalable Capital Broker.

Supported file formats: CSV, HTML, and PNG. PNG parsing uses a local ollama instance with a multimodal model — opt-in via fintl.toml (required only for Scalable broker PNG statements; gracefully skipped when not configured).

All your data stays on your machine. No need to trust another entity that is PSD2 certified.

How to install

git clone https://github.com/eschmidt42/fintl.git
cd fintl
uv sync
uv tool install .

After installation, fintl should be available on your PATH:

which fintl
# e.g. /Users/YOURUSER/.local/bin/fintl

How to use

1. Configure your ~/.config/petprojects/fintl.toml. For details see here.
2. Go to your bank account.
3. Select your service, e.g. Giro.
4. Export csv file or similar to ~/Downloads, or directly your source dir for your bank / service.
5. Optionally, if you've stored your file in ~/Downloads, run cd ~/Downloads followed by fintl store (uses your fintl.toml from step 1).
6. Optionally, if you want to process PNG screenshots via Ollama, start Ollama.
7. Run the etl via fintl etl (also uses your fintl.toml from step 1).
8. Upon success visualize / search your data via fintl plot or fintl search.

Please see here and below for more usage details.

Repo structure

• src/fintl/accounts_etl/ — core ETL logic: schemas, parsers, registry, runner
• src/fintl/cli/ — CLI entry point and subcommands (etl, store, search, plot)
• tests/ — tests for packages of this repo

Development

Run tests:

uv run pytest -n auto tests

Type check:

uv run ty check src

Lint, format, type check, test and all the other good stuff:

pre-commit run --all-files

For release steps see here.