---
id: tigerbeetle
version: "0.17.9"
license: unclear
license_treatment: permissive
maintenance: active
---

# tigerbeetle — The TigerBeetle client for Python.

License: permissive · Maintenance: active · Downloads: 202.2K/mo

## What it is and what it does

TigerBeetle is a distributed financial accounting database designed for high-performance, fault-tolerant ledger operations. This package provides the Python client to connect to a TigerBeetle cluster and perform account and transfer operations. It handles the complexity of distributed consensus and two-phase commits transparently, allowing you to create accounts with configurable constraints (e.g., debit/credit limits), perform atomic transfers between accounts, and batch multiple operations for efficiency.

The client is thread-safe and supports both synchronous (ClientSync) and asynchronous (ClientAsync) usage patterns. It requires Python 3.7 or later and can run on Linux (production), macOS, or Windows (development). The library provides structured types for accounts and transfers, status enums for result handling, and automatic request batching to reduce round-trips to the cluster.

Use it for:

- Build a multi-tenant accounting system where each tenant has isolated ledgers with enforced debit/credit constraints and audit trails.
- Implement a payment platform that atomically transfers funds between accounts with pending-then-posted two-phase semantics to prevent double-spending.
- Create a billing or invoicing service that batches account creation and transfer operations for high throughput with strong consistency guarantees.
- Develop a financial reconciliation tool that looks up account balances and validates transfer history across a distributed cluster.
- Build internal ledger systems for game economies, reward programs, or other applications requiring reliable, auditable account movements.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client library for TigerBeetle, a distributed financial accounting database, enabling creation and management of accounts and transfers with built-in batching and two-phase commit semantics.

Yes. The package is actively maintained, has no security vulnerabilities, requires no external runtime dependencies, and carries a permissive license. It is suitable for production use if you have a TigerBeetle cluster running. Install it if you need a Python client for a distributed financial ledger; do not install if you are looking for a standalone accounting library without a separate server component.

## Install

pip install tigerbeetle
uv add tigerbeetle
poetry add tigerbeetle

## Installing tigerbeetle

Before you install: Low friction installation with no runtime dependencies. Active maintenance with recent releases; last commit 2026-08-04. Supports current Python versions (3.7+) across Linux, macOS, and Windows.

License in practice: Permissive Apache license allows commercial and private use with minimal restrictions, making it suitable for production financial applications.

Quickstart:

pip install tigerbeetle

import tigerbeetle as tb
import os

with tb.ClientSync(cluster_id=0, replica_addresses=os.getenv("TB_ADDRESS", "3000")) as client:
    account = tb.Account(id=tb.id(), ledger=1, code=1, flags=0)
    results = client.create_accounts([account])

A TigerBeetle cluster must be running and reachable at the specified replica address. Linux >= 5.6 is the only supported production environment; macOS and Windows are supported for development only.

Verify before relying:

- Whether the TigerBeetle server cluster must be running separately or is bundled with the client package
- Performance characteristics and throughput limits for batch operations at scale
- Specific error recovery and retry semantics beyond what the excerpt documents

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 202.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tigerbeetle python client, distributed ledger accounting, financial transaction database, double-entry bookkeeping api, batch transfer processing, two-phase commit transfers, account ledger management, distributed-ledger, financial-accounting, batch-operations

[View on SkillFed](https://skillfed.io/packages/tigerbeetle) · [View on PyPI](https://pypi.org/project/tigerbeetle/)