Skip to content

Minimal yet valid double-entry accounting system in Python and command line

abacus is an Python package and a command line tool for accounting calculations. There is also a web interface demonstration.

With abacus you can perform a complete accounting cycle from a chart of accounts to financial reports. To start using abacus go to Quick Start section.

Few lines of sample code for a fictitious Dunder Mufflin paper company are listed below together with abacus outputs.

from abacus import Chart, Account, Report

# Define chart
chart = Chart(
    assets=["cash", "paper"],
    capital=["equity"],
    income=[Account("sales", contra_accounts=["refunds"])],
    expenses=["cogs", "salaries"],
)

# Use account balances form previous period
starting_balances = {"cash": 300, "paper": 2200, "equity": 2500}
ledger = chart.ledger(starting_balances)

# Post enties
ledger.post("cash", "sales", 2675, title="Sell paper for cash")
ledger.post("refunds", "cash", 375, title="Client refund")
ledger.post("cogs", "paper", 2000, title="Register cost of sales")
ledger.post("salaries", "cash", 500, title="Pay salaries")

# Show reports
rename_dict = {"cogs": "Cost of goods sold", "paper": "Inventory"}
report = Report(chart, ledger, rename_dict)
report.print_all()

bx ledger unlink --yes
bx init
bx chart add asset:cash
bx chart add asset:paper --title "Inventory"
bx chart add capital:equity
bx chart add income:sales contra:sales:refunds
bx chart add expense:cogs --title "Cost of goods sold"
bx chart add expense:salaries
echo {\"cash\": 300, \"paper\": 2200, \"equity\": 2500} > starting_balances.json
bx ledger load starting_balances.json
bx post --entry cash     sales 2675 --title="Sell paper for cash"
bx post --entry refunds  cash   375 --title="Client refund"
bx post --entry cogs     paper 2000 --title="Register cost of sales"
bx post --entry salaries cash   500 --title="Pay salaries"
bx close
bx report --all

            Trial balance
Account                   Debit   Credit
cash                       2100        0
paper                       200        0
refunds                     375        0
cogs                       2000        0
salaries                    500        0
equity                        0     2500
retained_earnings             0        0
sales                         0     2675
_isa                          0        0
_null                         0        0

            Balance sheet
Assets       2300   Capital          2300
  Cash       2100     Equity         2500
  Inventory   200     Retained       -200
                      earnings
                    Liabilities         0
Total        2300  Total             2300

            Income Statement
Income                              2300
  Sales                             2300
Expenses                            2500
  Cost of goods sold                2000
  Salaries                           500
Current profit                      -200

pip install abacus-py

Quick Start