beancount/beancount

Features

• Double-Entry Accounting Tools - Provides a plain-text double-entry accounting system that generates reports and balance checks from text files.
• Double-Entry Bookkeeping Engines - Implements core double-entry bookkeeping logic with plain-text data structures.
• Double-Entry Transaction Journals - Enforces a zero-sum constraint on every transaction, automatically interpolates missing amounts with currency-specific rounding.
• Price Databases - Records daily commodity prices into a local database for historical valuation and reporting.
• Financial Report Generators - A system that produces balance sheets, income statements, trial balances, and investment performance reports from ledger data.
• Account Management - Ships account opening, closing, and currency commodity declaration for structured financial tracking.
• Financial Account Categorization - Classifies accounts into five types for generating balance sheets and income statements.
• Hierarchical Account Structures - Implements a hierarchical account tree with colon-separated names under five root categories for structured bookkeeping.
• Account Naming Conventions - Provides colon-separated hierarchical naming for financial accounts to structure the ledger.
• Balance Assertions with Tolerance - Verifies account balances by computing acceptable tolerance from the assertion’s numeric precision, ignoring small rounding leftovers.
• Multi-Currency Ledger Management - Ledger uses any commodity as a unit of account and records exchange rates to track price history.
• Posting Price Annotations - Ledger attaches prices to postings for commodity conversion or capital gains calculations.
• Plain-Text Journal Workflows - Reads double-entry accounting data from plain-text journal files into an internal ledger structure.
• Ledger File Validators - Ledger loads a file and runs syntax and balance checks, reporting errors to standard error.
• Missing Amount Interpolations - Ledger omits one posting's amount and calculates it from the other postings.
• Personal Finance Management - Tracks income, expenses, assets, and liabilities with hierarchical accounts and periodic reports.
• Investment Portfolio Tracking - Tracks investment lots, cost basis, dividends, stock splits, and capital gains from a plain-text ledger.
• Lot Tracking - Tracks each commodity acquisition as a separate lot with cost, date, and label, then matches reductions using configurable booking strategies.
• Booking Strategies - Ledger applies FIFO, average cost, and custom lot-matching for multi-currency and date differences.
• Plain-Text Portfolio Trackers - A tool for tracking cost basis, lots, capital gains, dividends, and stock splits using plain-text journal entries.
• Bank Statement Ingestion - Downloads and converts bank statements into double-entry transactions automatically.
• Cost Basis Trackers - Ledger enforces lot matching for cost basis to detect errors and calculate capital gains on sales.
• Custom Query Language Compilers - Parses a custom query language into a syntax tree and compiles it to filter, aggregate, and report on the internal transaction database.
• Double-Entry CSV Importers - Maps CSV columns to accounting fields and generates double-entry transactions automatically.
• Financial File Importers - Fetches financial data files and matches them to importers for automatic transaction addition.
• Local Web Servers - A local web server that serves interactive reports and dashboards for browsing and analyzing accounting data.
• Display Formatting - Ledger displays monetary values with precision appropriate for each currency, adjustable through a display precision setting.
• Currency-Specific Rounding Rules - Ledger rounds amounts, prices, and costs computed from balancing legs to a configurable number of decimals.
• Plain-Text Accounting Parsers - Parses Unicode, time fields, tags, and sign flipping in plain-text accounting journal files.
• Financial Performance Reports - Generates portfolio allocations, capital gains, and budget reports from the transaction journal.
• Reconciliation Tools - Reconciles shared accounts and computes net amounts owed between contributors.
• Detailed Posting Annotations - Captures cost basis, prices, dates, metadata, and tags for each transaction leg, enabling detailed financial records.
• Custom Statement Parsers - Implements a custom protocol for parsing XML, PDF, and other sources into ledger statements.
• Equity Award Lifecycles - Tracks the full lifecycle of equity awards from grant to share conversion.
• Expense Trackers - Splits and settles shared expenses with automatic contribution tracking.
• Financial Pools - Segregates accounts into separate pools such that each pool balances independently.
• Plugin Filters - Applies custom Python scripts to filter, modify, or annotate transactions as they are loaded into the ledger.
• Transaction Tag Filters - Assigns tags to transactions for filtered reports on specific sets like trips or projects.
• Financial Statement Importers - Downloads and converts bank statements into ledger transactions with duplicate detection.
• General Ledger Reporting - Clears and summarizes balances for a chosen time range to produce period-based reports.
• Net Income Calculations - Summarizes income and expense changes over a period to show net profit or loss.
• Market Price Fetching Tools - Ledger retrieves current market prices for currencies and securities from external sources using a CLI tool or custom scripts.
• Stock Split Handlers - Ledger splits a position while preserving lot attributes like purchase date and user label.
• Unrealized Gain/Loss Reports - Ledger computes market value of positions and displays unrealized gains or losses over time.
• Accounting Invariants - Verifies that an account holds exactly the declared amount of a commodity at a given date.
• Account Balance Queries - Sums all account balances to produce a snapshot at a specific point in time.
• Currency Exchange Recording - Ledger records currency exchanges without a cost basis, distinguishing them from commodity purchases.
• Python Plugin Integrations - Allows custom Python modules to transform, create, or delete accounting directives.
• Custom Query Languages - Filters, sorts, and aggregates transactions using a SQL-like syntax for accounts, dates, and amounts.
• Multi-Format Financial Importers - A framework for importing CSV, OFX, and other financial data into plain-text double-entry transactions with deduplication.
• Accounting Ledger Viewers - Ledger serves an interactive web app for browsing and analyzing accounting data.
• Accounting Directive Syntax - Defines a strict plain-text syntax for ledger directives to record transactions, accounts, and balances.
• Scripted Data Analysis - Loads accounting directives into custom Python scripts for analysis beyond the built-in reports.
• SQL Query Editors - Writes SQL-like queries to filter, aggregate, and summarize transaction postings.
• Scripting APIs - Provides a Python API for loading, modifying, and saving ledger data with debugging tools.
• Custom Logic Extensions - Extends accounting logic through a plugin system and Python API for custom transformations and reports.
• Plugin Extensibility - Modifies accounting directives by adding, removing, or altering transactions via plugins.
• Ledger Querying - Runs SQL-like queries interactively in a shell or executes single queries from the terminal.
• Test Data Generators - Ledger generates years of realistic financial transactions for testing and tutorials.
• Portfolio Return Computation - Ledger analyzes cash flows per investment, groups into portfolios, and produces performance reports.
• Directive Enrichment Attachments - Attaches notes, documents, tags, links, and metadata to accounting directives for enrichment.
• Precision Settings - Determines fractional digits per currency for aligned, rounded report output.
• Plugin-Based Architectures - Injects custom Python modules at parse and processing stages to filter, modify, or create accounting directives.
• Transaction Counterparty Annotations - Records transaction counterparty and description for context in financial reports.
• Data Management Systems - Double-entry bookkeeping language for financial records.
• Personal Finance - Plain text double-entry accounting system with web UI support.

Star history