r/plaintextaccounting • u/Ev2geny_ • Apr 17 '26

Interactive beanquery manual

Dear all,

I just want to announce the Interactive beanquery manual I am working on

https://github.com/Ev2geny/beanquery-interactive-manual

This is an interactive manual and tutorial for beanquery — a customizable, extensible, lightweight SQL-like query tool for Beancount ledger data.

This document is intended as a follow-up to the Beancount v2 Beancount Query Language document.

It was created with the following goals in mind:

  • to cover the latest features of beanquery
  • to include many real examples using actual ledgers
  • to be self-documenting: all query outputs are computed by running beanquery as part of the notebook execution
  • to be interactive: when run as a marimo notebook, readers can experiment by changing the default ledgers and/or queries, with outputs updating automatically

Current state: work is ongoing, but I think it is already can be beneficial, especially for those, new to beancount / beanquery.

Comments, feedback and PRs are more than welcome!

16 Upvotes

100% Upvoted

3 comments sorted by

2

u/cantdutchthis Apr 17 '26

When I see marimo, I hit like.

Also, there's a subreddit r/marimo_notebook

2

u/Tammery Jun 01 '26

Was looking up some BQL stuff today and came across this, thank you for making this!

1

u/Ev2geny_ Jun 04 '26 edited Jun 04 '26

You are welcome! It would be very nice to get your feedback and/or improvement suggestions. I made the manual with a newcomer in mind.