Lazy Beancount is Beancount accounting system packaged in Docker with batteries included:
- Fava with dashboards
- Beancount-import and some importers set up to work with it out of the box:
- from Evernight/beancount-importers: Wise, Monzo, Revolut
- IBKR (adapted from uabean)
- more importers can be integrated/enabled on request
- Streamlit-based interface to provide additional functionality: tracking total values of the accounts, fetching commodity prices from the browser
- Pre-installed plugins:
- Configuration generator and example supporting any number of accounts (cash, investments, savings), multiple currencies, examples of common useful shortcuts and a couple of useful hacks.
- All tested together (manually) in a coherent setup.
The main goal is to enable gradual and incremental migration of personal finances into Beancount.
Full guide is located at https://lazy-beancount.xyz/. The approach roughly follows these principles:
- Some of the values should be tracked precisely (e.g. net worth)
- Other things are an approximation (e.g. in expenses breakdown, unclassified or some misclassified entires are ok)
- Data entry should be automated or easy
- But it should be possible to track things to any level of precision if you need to
git clone https://github.com/Evernight/lazy-beancount
cd example_data
docker compose up
This will pull repository with the example and config templates, and also pull and run the latest version of the package from the Docker Hub. After this is done, go to http://localhost:8777/.
Fava is also available on port 5003, importer interface is available on port 8101 (ports are overridable via config in docker-compose.yml).
You can just pull image from the public repository:
docker pull vandereer/lazy-beancount:latest
or build it yourself:
git clone https://github.com/Evernight/lazy-beancount
cd lazy-beancount
docker build . -t lazy-beancount
To start, run:
./lazy_beancount.sh example_data
Use ./lazy_beancount.sh data when you want to start adding your own data under the data directory.
Commands are available in the container as:
docker exec -it lazybean bean-price example_data/main.bean -i --date=2024-01-05
If you want to be able to upgrade individual packages and experiment with other (and your own) plugins or additional importers, you may go down this route.
First, clone this repository into your desired location
git clone https://github.com/Evernight/lazy-beancount
cd lazy-beancount
Install conda
brew install miniconda
Then create and activate the environment
conda create -n lazy-beancount-env python=3.12.3
conda activate lazy-beancount-env
Install required packages in the environment
pip3 install -r requirements.txt
Run Fava on your ledger from the repository folder
PYTHONPATH=PYTHONPATH:. fava main.bean
Go to http://127.0.0.1:5000 and explore Fava.
It's not recommended to expose the ports, various system and data through a public server unless you really know what you're doing. This setup has not been developed and tested for security and authentication when run as a public service.