Here we track the hledger project's finances, for clarity, dogfooding, and as a real-world example of FOSS project accounting with hledger. (shortcut: https://finance.hledger.org)
See also the FINANCE section on the hledger website, eg Sponsor hledger, Regression bounty and FINANCE notes.
In this directory:
Justfile- maintenance and reporting scripts.justto see help.hledger.conf- local hledger configmain.journal- top-level journal fileaccounts.journal- account declarationsoc.*- hledger open collective CSV, conversion rules, journalother.journal- other transactions, manually recorded
The rest of this README is reports, intended to be somewhat readable on Github. These are regenerated semi-automatically, and may improve as data and scripts are cleaned up.
Update process:
- View latest Open Collective transactions
- Check all parameters are set to All
- Click Download CSV
- Turn on Separate transactions compatibility
- Check other parameters, defaults should be ok
- Click Export CSV, wait for dowload to complete
- Ensure that it downloaded, then close the Export CSV dialog
- In finance dir,
just update(gather csv, regenerate journal and reports) - Deal with any snafu (missing python deps..)
- Review diffs, investigate/resolve any problems
- Check that the latest asset balance matches https://opencollective.com/hledger#category-BUDGET > TODAY'S BALANCE
- Commit
git pushto update https://github.com/simonmichael/hledger_finance
| account | assets:opencollective | Total: |
|---|---|---|
| commodity | USD | USD |
| 2017 | 100.92 | 100.92 |
| 2018 | 290.99 | 290.99 |
| 2019 | 372.66 | 372.66 |
| 2020 | 1437.23 | 1437.23 |
| 2021 | 4689.88 | 4689.88 |
| 2022 | 6863.66 | 6863.66 |
| 2023 | 7465.73 | 7465.73 |
| 2024 | 7372.70 | 7372.70 |
| 2025 | 7488.38 | 7488.38 |
| total |
| account | revenues:donations | expenses:bounties | expenses:fees | expenses:misc | Total: |
|---|---|---|---|---|---|
| commodity | USD | USD | USD | USD | USD |
| 2017 | 120.00 | 0 | -19.08 | 0 | 100.92 |
| 2018 | 225.00 | 0 | -34.93 | 0 | 190.07 |
| 2019 | 105.00 | 0 | -23.33 | 0 | 81.67 |
| 2020 | 1254.38 | 0 | -189.81 | 0 | 1064.57 |
| 2021 | 4721.00 | -760.01 | -708.34 | 0 | 3252.65 |
| 2022 | 3744.00 | -400.00 | -592.10 | -578.12 | 2173.78 |
| 2023 | 1868.00 | -862.00 | -303.93 | -100.00 | 602.07 |
| 2024 | 1277.00 | -1198.14 | -171.89 | 0 | -93.03 |
| 2025 | 139.00 | 0 | -23.32 | 0 | 115.68 |
| total | 13453.38 | -3220.15 | -2066.73 | -678.12 | 7488.38 |
| Commodity | 2025-01-01..2025-01-23 | |
|---|---|---|
| Revenues | ||
| donations | USD | 139.00 |
| Guest | USD | 52.00 |
| incognito | USD | 50.00 |
| Joyful Systems | USD | 10.00 |
| October Swimmer | USD | 10.00 |
| Jack Todaro | USD | 5.00 |
| Brandon Barker | USD | 2.00 |
| Frank | USD | 2.00 |
| James Blachly | USD | 2.00 |
| Ken Ewing | USD | 2.00 |
| Rishi Hyanki | USD | 2.00 |
| Samim Pezeshki | USD | 2.00 |
| Total: | USD | 139.00 |
| Expenses | ||
| fees | USD | 23.32 |
| Open Source Collective | USD | 13.90 |
| STRIPE | USD | 6.00 |
| PAYPAL | USD | 3.42 |
| Total: | USD | 23.32 |
| Net: | USD | 115.68 |
2017 101
2018 190 +
2019 82
2020 1065 +++++++
2021 3253 +++++++++++++++++++++
2022 2174 ++++++++++++++
2023 602 ++++
2024 -93
2025 116
2017 101
2018 291 +
2019 373 ++
2020 1437 +++++++++
2021 4690 +++++++++++++++++++++++++++++++
2022 6864 +++++++++++++++++++++++++++++++++++++++++++++
2023 7466 +++++++++++++++++++++++++++++++++++++++++++++++++
2024 7373 +++++++++++++++++++++++++++++++++++++++++++++++++
2025 7488 +++++++++++++++++++++++++++++++++++++++++++++++++
hledger assets
bal --depth=1 ^assets --historical
⢰⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⢒⣒⣒⣒⣒⣒⣒⣒⡒⠒⠒⠒⠒⠒⠒⠒⢲
8000 ⢸ ⠠⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤ ⣀⡀ ⣀⣠⠴⠒⠳⠤⠤⠏⠉⠉⠉⠉⠉ ⠱⢤⢤⡤ ⢸
⢸ assets ⢀⣄⣀⠤⠶⠖⠉⠁⠉⠉⠁ ⢸
⢸ ⡀ ⣠⠞⠉⠈ ⢸
6000 ⢸ ⢀⡖⠳⠋⠁ ⢸
⢸ ⢀⡖⠉ ⢸
⢸ ⣠⠶⠋ ⢸
4000 ⢸ ⣀⣤⠞⠁ ⢸
[USD] ⢸ ⣀⠞⠁ ⢸
⢸ ⢀⣠⠖⠁ ⢸
2000 ⢸ ⢀⣠⠖⠉ ⢸
⢸ ⣀⣠⠤⠖⠒⠋⠉ ⢸
⢸ ⢀⣀⣀⣀⣀⣀⣠⣤⣤⣤⣤⣤⡤⠤⠤⠤⠤⠤⠤⠤⠤⠶⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠓⠋⠉⠉⠁ ⢸
0 ⠘⠂⠒⠒⠲⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠆⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠆⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠖⠒⠒⠒⠒⠘
2017 2018 2019 2020 2021 2022 2023 2024 2025
hledger monthly revenues
bal --depth=1 ^revenues --monthly
⢰⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⢒⣒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⢲
⢸ ⢸⢸ ⢰⢲ ⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤ ⢸
⢸ ⢠⢦⢸⢸⢰⢲⢸⢸ revenues ⢸
⢸ ⢠⠤⠤⠴⠋⠘⠚⠘⠚⢸⢸⠸⢤ ⢸
400 ⢺ ⢸ ⢸⢸ ⢸ ⢠⢤ ⡤⡄ ⢸
⢸ ⢠⢤⢠⢄⢸ ⠸⠼ ⠸⠤⠼⢸ ⡇⡇ ⢸
⢸ ⢸⢸⢸⢸⢸ ⢸ ⡇⡇ ⢸
⢸ ⢰⠚⢸⢸⠸⡼ ⠸⣄ ⡇⡇ ⡤⡄ ⢸
[USD] ⢼ ⢸ ⢼⢸ ⢸ ⠠⣿⠄ ⡇⡇ ⡇⡇ ⢸
⢸ ⢀⡀ ⣸ ⢸⣸ ⠘⠒⠒⠛⠒⠹⠤⠤⠤⠴⠉⠶⠋⡇ ⡏⠁⣇ ⡇⣇⡀ ⣀ ⢸
⢸ ⡔⠋⠙⠒⠒⠒⠚⠉⠁ ⠁ ⠉⠉⠉⠁ ⠈⡇ ⡇ ⣇⡀⡇ ⢸
⢸ ⡖⡆ ⡇ ⣇⣀⣀⣀⣀⣀⡇ ⣇⡇ ⢸
⣸ ⠠⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠖⠒⠒⠒⠒⠦⠤⠤⠤⠇⠧⠤⣄⣤⡤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠇ ⢸
0 ⠘⠒⠒⠒⠂⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠰⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠰⠆⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠰⠆⠒⠒⠒⠘
2017 2018 2019 2020 2021 2022 2023 2024 2025
hledger monthly expenses
bal --depth=1 ^expenses --monthly
⢰⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⣒⡒⠒⠒⠒⠒⠒⠒⢲
600 ⢹ ⠠⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤ ⢀⣄ ⡇⡏ ⢸
⢸ expenses ⢸⢸ ⡇⡇ ⢸
⢸ ⢸⢸ ⡇⡇ ⢸
⢸ ⢸⢸ ⡇⡇ ⢸
400 ⢹ ⢰⢲ ⢸⢸ ⡇⡇ ⢸
⢸ ⢸⢸ ⢸⢸ ⠶⡄ ⡠⠇⡇ ⢸
⢸ ⢸⢸ ⢰⢹ ⢸⢸ ⡇⡇ ⡇ ⡇ ⢸
[USD] ⣸ ⢠⠼⢸ ⢸⢸ ⢸⢸ ⢠⣲ ⢀⣒⡀ ⢀⡇⡇ ⡇ ⡇ ⢸
200 ⢸ ⢸ ⢸⢠⠼⢸⢠⢶ ⢸⢸ ⢸⢸ ⣿ ⡇⡇⡖⡄ ⡇ ⡇ ⢸
⢸ ⢸ ⢸⢸ ⢸⢸⢸ ⢸⠈⢹ ⢸⢸ ⢠⠒⡆⢠⡖⠉⢲⡄ ⡇⠓⠃⣇⡀ ⡤⡄ ⡇ ⠧⡄ ⢸
⢸ ⢀⣄⢀⣀⢠⠤⠼ ⠘⠚ ⠘⠞⢸⣰⠋ ⠸⠤⢤⣘⢸ ⠸ ⣇⠸⡇ ⢸⠇ ⡇ ⡇ ⡇⡇ ⡇ ⠧⡄ ⢸
⣸ ⣠⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣠⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⡤⣤⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣠⣀⣀⡴⠒⠒⠒⠒⠒⠒⠒⠚⠁⠘⠚⠈⠉ ⠉⠈⠒⠋⠁⠈⠛⠁ ⠈⠙⠒⠛⠒⠃ ⠓⠦⠇⠧⠤⠤⠤⠇ ⠙ ⢸
0 ⠘⠒⠒⠒⠂⠶⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠶⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠖⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠂⠶⠐⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠲⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠒⠰⠆⠒⠒⠒⠘
2017 2018 2019 2020 2021 2022 2023 2024 2025