---
id: python-bitcoinlib
version: "0.12.2"
license: unclear
license_treatment: copyleft
maintenance: aging
---

# python-bitcoinlib — The Swiss Army Knife of the Bitcoin protocol.

License: copyleft · Maintenance: aging · Downloads: 420.4K/mo

## What it is and what it does

python-bitcoinlib is a low-level Python library for working directly with Bitcoin protocol internals. It provides data structures and tools for manipulating transactions, scripts, keys, serialization, and blockchain parameters, with a design philosophy that mirrors the Bitcoin codebase closely. The library separates consensus-critical code from non-consensus modules like RPC support, wallet utilities, and network communication.

The package is designed for developers who need to build tools that interact with Bitcoin at the protocol level—parsing transactions, validating scripts, constructing custom transactions, or communicating with nodes via RPC. It handles low-level details like endianness conversions and immutable/mutable object distinctions. The library requires libssl-dev and works with v24.0 or later for RPC functionality.

Use it for:

- Build custom Bitcoin transaction builders or signers that need to manipulate transaction internals
- Parse and validate Bitcoin scripts or create custom script logic
- Interact with a node via RPC to query blockchain data or submit transactions
- Implement Bitcoin address generation, key management, or wallet-related functionality
- Analyze Bitcoin protocol data structures or implement consensus-critical validation logic

## Worth the install?

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

Provides low-level Python tools to work with Bitcoin data structures, transactions, scripts, and the Bitcoin protocol, including RPC interface support for Bitcoin Core.

Yes, if you need low-level Bitcoin protocol manipulation in Python. The library has no runtime dependencies, low install friction, and an active if aging maintenance status. The copyleft license is straightforward for open-source use. However, the last release was 2023-06-03 and updates are infrequent—verify compatibility with your Python version and requirements before relying on it for production systems.

## Install

pip install python-bitcoinlib
uv add python-bitcoinlib
poetry add python-bitcoinlib

## Installing python-bitcoinlib

Before you install: Low install friction with no runtime dependencies. Maintenance status is aging—last release was 2023-06-03 and last commit 2025-03-14—so updates are infrequent but the repository remains active and not archived.

License in practice: Licensed under LGPLv3+, a copyleft license. Any derivative work or modification must be distributed under compatible terms; linking from proprietary code is permitted if the library remains separate.

Quickstart:

pip install python-bitcoinlib

from python_bitcoinlib.core import x, lx, b2x
# Work with Bitcoin data structures and protocol

Requires libssl-dev system library. Bitcoin Core v24.0 or later for RPC interface compatibility.

Verify before relying:

- Whether the package works with modern Python versions given no explicit requires_python constraint
- Current state of the 'in flux' modules and their production readiness
- Whether consensus-critical code has been audited for correctness against current Bitcoin Core

## Package facts

- License: not declared (copyleft)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 420.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bitcoin protocol library python, bitcoin transaction manipulation, bitcoin script evaluation, bitcoin core rpc interface, bitcoin serialization deserialization, bitcoin cryptography keys, bitcoin address wallet tools, bitcoin-protocol, cryptocurrency, cryptography

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