Transform finance data from CSV into LDG assisted by AI.
Go to file
2025-03-16 09:47:11 -04:00
src/toldg Implement numpy based prediction feature 2025-03-16 09:47:11 -04:00
.gitignore Update project structure and move to beancount 2025-03-02 11:08:33 -05:00
.pre-commit-config.yaml Update project structure and move to beancount 2025-03-02 11:08:33 -05:00
LICENSE Initial commit 2023-06-18 17:03:48 +02:00
poetry.lock Start to implement prediction 2025-03-15 20:07:50 -04:00
pyproject.toml Start to implement prediction 2025-03-15 20:07:50 -04:00
README.md Implement new mapping format 2025-03-02 13:32:08 -05:00

ledgerai

Script to transform CSV files into beancount accounting files.

Usage

To transform CSV data into Beancount first install the package via poetry install.

You can then run toldg from the directory where your configuration file and your ledger data is located.

poetry -P ledgerai run toldg

To visualize the data with fava, enable the venv and run fava from there.

eval "$(poetry env activate)"
fava your_ledger.beancount

Architecture

The script takes a directory in which it recursively searches for CSV and LDG files. From these files, it generates a single ledger accounting file that includes all transactions.

Ledger files are appended to the output file without modifications.

However, the transaction for the CSV files are extended with their account2 information, i.e, the category of the transaction. Optionally, these transactions can also get a more meaningful description and tags.

The mapping information are stored in a file mappings.json. It maps a unique identifier for each transaction (based on the filename and full CSV row) to a respective account2.