Installation

Requirements

macOS 26 or later, on a Mac with Apple silicon. Nothing else: the app carries everything it needs inside — its own Python, Beancount, the Fava library and Git. It does not use, and does not touch, any Python, Beancount, Fava or Git you may already have installed.

Why does Fava show up in the engine?

Tallystick replaces Fava’s web interface, but it reuses Fava’s well-tested calculation code as a library — period handling, account trees, conversions, filters — instead of re-implementing it. That is why the numbers match Fava’s exactly. It ships inside the app, no web server is ever started, and you never have to run or see it.

Install the app

Homebrew

brew install --cask barcia/tap/tallystick

The full name adds the tap, trusts it and installs, in one step. The app keeps itself up to date (see below), so a plain brew upgrade leaves it alone; brew upgrade --cask --greedy tallystick updates it through Homebrew anyway.

Download

Download the disk image from the home page, open it and drag Tallystick to your Applications folder.

First launch

1. Open Tallystick. With no ledger open you see No Ledger Open and an Open Ledger… button.

2. Choose the folder that holds your ledger. The app finds the main file in it, or asks which one it is. See Open your ledger.

3. Starting engine… and Loading ledger… show for a moment, and then your Income Statement for this year, month by month.

4. If the folder had no Git history, the app starts one and tells you so. From then on every save can be reviewed and undone: see Saving and committing.

Nothing is downloaded, and the app works without an internet connection from the first launch. Its only connection is the daily check for updates, which you can turn off.

No ledger yet? The app opens ledgers, it does not create them. A folder with a main.beancount like this one is enough to start:

option "title" "My ledger"
option "operating_currency" "EUR"

2026-01-01 open Assets:Bank:Checking
2026-01-01 open Expenses:Groceries
2026-01-01 open Equity:Opening-Balances

The Beancount documentation explains the language.

Next

• Open your ledger, then take the tour.
• Add a transaction and see it saved and committed.
• Capture expenses on the go with the iPhone companion.

Updates

Once a day the app checks whether there is a new version and, if so, shows what changed and offers to install it: Install Update replaces the app and restarts it. You can also check at any time with Tallystick ▸ Check for Updates…. To turn the checks off, or to let updates install on their own, see Settings ▸ Updates.

Coming from Beancount Desktop

Tallystick is the new name of Beancount Desktop, from the version after 0.2.0. It is the same app, and the update arrives as any other:

• The file keeps its old name. An update installs over the app you have, so in Applications it may still be called Beancount Desktop. Rename it to Tallystick in the Finder whenever you like. With Homebrew, brew upgrade --cask --greedy moves you to the tallystick cask.
• Open your ledger once more. The app now keeps its settings under a new name, so the first launch is like the very first one: choose the ledger folder again. Your ledger, its Git history and your iPhone drafts are untouched. Saved views and the Git name and email in Settings start empty.
• Old exchange files still work. Context and drafts files are now .tallycontext and .tallydrafts; the .bcdcontext and .bcddrafts written before the rename still import on both devices.