tigerbeetle

library0.17.3pypypiunverified

The official Python client for TigerBeetle, a high-performance financial accounting database. Current version 0.17.3, released irregularly alongside server updates. Requires Python >=3.7 and a running TigerBeetle server (typically started via Docker).

database payments

pip install tigerbeetle

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · TIGERBEETLE

tigerbeetle

databasepythonv0.17.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Client

✓ from tigerbeetle import Client

✗ from tigerbeetle import Client

Account

✓ from tigerbeetle import Account

Transfer

✓ from tigerbeetle import Transfer

Create a TigerBeetle client and create a single account.

import os from tigerbeetle import Client client = Client( cluster_id=0, replica_addresses=[os.environ.get('TB_ADDRESS', '3000')], ) account = { 'id': 1, 'debits_pending': 0, 'debits_posted': 0, 'credits_pending': 0, 'credits_posted': 0, 'user_data': 0, 'reserved': 0, 'ledger': 1, 'code': 1, 'flags': 0, } create_accounts_result = client.create_accounts([account]) print(create_accounts_result)

Debug

Known issues

breakingClient version must be >=0.16.4 and server version must be >=0.16.78 (for 0.17.3) due to protocol incompatibility. Mismatched versions cause connection errors or data corruption.

fix

Always upgrade both client and server together. Check release notes for compatible version pairs.

affects: all >=0.16.0

gotchaClient is not thread-safe; creating multiple clients or sharing a single client across threads leads to undefined behavior.

fix

Use one client per thread or synchronize access with locks.

affects: all

deprecatedThe Account and Transfer classes from earlier versions are deprecated. Use plain dictionaries with snake_case field names.

fix

Replace class instances with dicts as shown in quickstart.

affects: >=0.13.0

gotchaAccount IDs must be 128-bit unsigned integers; using Python ints beyond 2^128-1 will overflow silently.

fix

Ensure account IDs fit within 128 bits. Use smaller values or hash IDs to fit.

affects: all

Upgrade

Version history

0.17.3latest on PyPI · released May 4, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

55 hits · last 30 days

node

Resources

githubhttps://github.com/tigerbeetle/tigerbeetle ↗

packagehttps://pypi.org/project/tigerbeetle/ ↗

homepagehttps://tigerbeetle.com ↗