Tracking Personal Finances using Python šŸ

Learn how to track your personal finances using Python, Beancount, Plaintext Accounting, and Double-Entry Bookkeeping.

500+ happy readers

Tracking Personal Finances using Python šŸ

Extremely thorough and well-researched

"Tracking Personal Finances using Python is extremely thorough and well-researched. Siddhant's love of plaintext accounting shows through in the writing. I’m a regular beancount user, and his book still taught me new techniques for tracking my finances easily."

I highly recommend it - super useful!

"A friend of mine told me about Siddhant's book while he was writing it. I was just getting into Beancount to help organize my finances, and the book was an invaluable guide. I highly recommend it - super useful!"

The book has paid for itself many times over.

"I started using Beancount in Dec last year thanks to this book. I can now safely say that the book has paid for itself many times over. If you are interested in plain text accounting but don't know where to start, this is a great place to begin."

0 to a working workflow in 1 day

"I really liked the content and was able to sift through it and go from 0 to a working workflow with 3 sources and 3 months of data in 1 day."

The chapters on writing (AND TESTING!) custom providers are really helpful.

"I've actually already finished your book, and the chapters on writing (AND TESTING!) custom providers are really helpful, so I'll be able to write my simplefin importer that I want to make."

I got a year's worth of financial transactions imported in a day thanks to the leg up this book gave me.

"This was the only resource I could find that actually walks you through how to do that and provides sample code. I've never written a python program before, but the concepts were straightforward and I got a year's worth of financial transactions imported in a day thanks to the leg up this book gave me."

Learn to Automate Personal Finance Tracking using Python

Tracking Personal Finances using Python is a book that teaches software developers how to manage their personal finances using Python and plain-text files.

The Python ecosystem contains an excellent package called Beancount that provides the foundations for working with money. We'll take Beancount as the starting point to build an application that serves as your single point of contact for your complete financial history, and:

  1. store every piece of data from all your bank accounts (strictly on your machine)
  2. provide a unified dashboard to look up anything related to your finances
  3. import new financial transactions from your bank accounts on a continuous basis
  4. offer customized tools to analyze your past financial behavior, spending patterns, income sources, and current liabilities

The final result is a Git repository on your computer, acting as your own personal finance system.

Get started

Open-Source Personal Finance Privacy

The workflow that you will learn in the book prioritizes data privacy by using only open-source software and keeping your financial data entirely on your computer, making sure that it never touches the cloud.

Most personal finance apps are either closed-source or store data on external servers, creating privacy and security risks. In this book, we will show you a different approach.

You control your data at all times. All your financial information will be stored in plaintext files in a Git repository on your machine. Because the data never leaves your computer, there's no need for complex encryption. You control access completely.

Open source, fully auditable. All the tools we use (and show) are open-source, meaning it has already gone through considerable external review from other security researchers and developer. No hidden backdoors. No proprietary lock-in.

Get started

A Developer-Friendly Personal Finances Workflow

Imagine querying your bank transactions with SQL, automating transaction imports, and analyzing your spending patterns with Python scripts. That's the power of plaintext accounting combined with developer tools.

Built for your workflow. Manage your finances entirely from the terminal using your favorite editor. Store everything in a Git repository for version control, auditing, and easy backups. No GUI, no distractions. It's all plaintext files and code.

Beancount and Python. Learn how to use Beancount, the plaintext accounting engine, and Python for financial automation. Write custom scripts to categorize transactions, generate reports, and build financial dashboards. The possibilities are endless when your data is plaintext and code-queryable.

Query your finances. Run SQL queries on your transaction history to discover spending patterns, track income sources, and analyze your financial behavior. Extract insights at a level of flexibility that traditional finance apps simply can't provide.

Get started

Table of Contents

  • 01
    Introduction
    We'll start with a light introduction including some background and motivation on why I wrote the book in the first place.
  • 02
    Plain Text Accounting
    We'll cover plain text accounting, double entry bookkeeping, and related concepts to get you productive quickly.
  • 03
    Beancount
    We'll introduce Beancount, explore its ledger format, and learn the data structures and tools for working with money in Python.
  • 04
    Workflow
    This chapter will build upon the previous chapter by helping you set up your own Beancount-based workflow to track your personal finances, including writing a converter for your bank statements.
  • 05
    Testing
    This chapter helps you establish a regression testing workflow for the Beancount importers you wrote in the previous chapter.
  • 06
    Reporting
    In the last chapter, we'll explore visualization tools and techniques for analyzing your financial data.

Frequently Asked Questions

What is Tracking Personal Finances using Python?
Tracking Personal Finances using Python is a book that teaches software developers how to track their finances using Python. The reader is introduced to concepts such as plaintext accounting, double entry bookkeeping, Beancount, after which they are walked through importing their own financial transactions from their banks into a Beancount-backed ledger.
What formats is the book distributed in?
The book is distributed in the PDF and EPUB formats. Once you purchase the book, you will have access to both and can decide whichever you prefer more.
Do I need to have a programming and/or Python background?
A programming background is required. If you can read and write Python code, that's excellent. If not, some experience with a similar high-level programming language (e.g., Ruby, Javascript, etc.) and willingness to read and write Python code will be helpful.
What operating system do I need to have?
If you're on macOS or a Linux-based operating system, you should be good to go. If you're using Windows, you should be able to get good results using WSL (Windows Subsystem for Linux).
Are there any software requirements I need to be aware of?
We'll be mainly working on the command line shell and writing code in a text editor. You can choose any text editor that you feel comfortable with, as long as it can be configured for writing Python code.
Is the book using Beancount 2 or Beancount 3?
As of June 2025, the book has been updated to reference Beancount 3!

About the Author

Hey! My name is Siddhant, and I'm a software developer located in Munich, Germany. šŸ‡©šŸ‡Ŗ

I've been writing Python code for more than a decade now. In my spare time, I maintain several open-source packages written in Python, which have totaled more than 2 million downloads on the PyPI.

A few years ago I discovered the world of plain text accounting and Beancount. Since starting to track my personal finances using Beancount, I can honestly say that this is the one technology that has had an outsized impact on my life. I love sharing what I've learned and this book is another attempt at doing that.

I hope you enjoy it! If you have questions, feel free to reach out on Bluesky.

Get started