breez-sdk-spark
Python language bindings for the Breez Spark SDK
Decision gist · record as of 2026-08-14
Yes—if you are building a Bitcoin or stablecoin payment feature in Python and want to avoid the operational burden of running a Lightning node or managing keys yourself. The SDK is free, actively maintained, has no runtime dependencies, and covers a broad range of payment protocols. The main gotcha is the required API key; beyond that, install friction is low and security posture is solid (no vulnerabilities reported, MIT license, recent release).AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a free API key obtained from breez.technology; without it, SDK initialization will fail.
- Medium install friction: precompiled wheels available across macOS, Linux (x86_64, aarch64), and Windows.
- Package is actively maintained with a recent release and no runtime dependencies to manage.
License · maintenance · safety
MIT (permissive) — MIT license (permissive) places no restrictions on commercial or private use; you may modify and distribute freely with attribution.
last release 2026-08-12 (2 days) · last repo commit 2026-08-14 · 54 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 114,713 downloads/mo, #12,283 on PyPI
Alternatives
Verify before relying
pip install breez-sdk-spark
from breez_sdk_spark import BreezSDK
# Initialize SDK with API key (required from breez.technology)
sdk = BreezSDK(api_key='your_api_key')- Exact Python version support (requires_python field is unspecified in metadata)
- Whether passkey login and multi-device sync work out-of-the-box or require additional backend setup
- Real-world latency and fee characteristics for Spark vs. Lightning vs. on-chain payments
- Availability and stability of Spark Operators that facilitate the shared signing protocol
What it is and what it does
Breez SDK - Spark is a Python wrapper around Breez's Rust-based Bitcoin and stablecoin payment SDK, designed to let developers add non-custodial payment flows to their applications without running a full node. It abstracts away the complexity of Bitcoin, Lightning, and Spark (a Layer 2 protocol built on multi-signature delegation) so that users can send and receive payments in BTC, USDT, USDC, and Spark tokens via Lightning addresses, LNURL-Pay, on-chain addresses, and Spark addresses.
The SDK handles key management (keys stay with the user), multi-device sync, payment persistence, and automatic on-chain claims. Under the hood, Spark uses a shared signing protocol where Spark Operators facilitate instant settlement without requiring blockchain confirmations, while funds remain non-custodial and can be exited to the Bitcoin main chain at any time. You'll need a free API key from Breez to initialize the SDK.
Use it for
- Add Bitcoin/Lightning payment acceptance to a Python web app or service without managing your own node infrastructure.
- Build a mobile or desktop wallet that supports multiple payment protocols (Lightning, on-chain, Spark tokens) with a single SDK.
- Implement stablecoin (USDT/USDC) send functionality in a fintech or remittance application.
- Enable seedless, passkey-based login for a Bitcoin app with real-time balance sync across devices.
- Integrate Spark token issuance and transfer for custom tokenized value on a Bitcoin Layer 2.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes—if you are building a Bitcoin or stablecoin payment feature in Python and want to avoid the operational burden of running a Lightning node or managing keys yourself.
The SDK is free, actively maintained, has no runtime dependencies, and covers a broad range of payment protocols. The main gotcha is the required API key; beyond that, install friction is low and security posture is solid (no vulnerabilities reported, MIT license, recent release).
Install
breez-sdk-spark on PyPI
Before you install
Medium install friction: precompiled wheels available across macOS, Linux (x86_64, aarch64), and Windows. Package is actively maintained with a recent release and no runtime dependencies to manage.
Requires a free API key obtained from breez.technology; without it, SDK initialization will fail.
License in practice
MIT license (permissive) places no restrictions on commercial or private use; you may modify and distribute freely with attribution.
Quickstart
pip install breez-sdk-spark
from breez_sdk_spark import BreezSDK
# Initialize SDK with API key (required from breez.technology)
sdk = BreezSDK(api_key='your_api_key')Verify before relying
- Exact Python version support (requires_python field is unspecified in metadata)
- Whether passkey login and multi-device sync work out-of-the-box or require additional backend setup
- Real-world latency and fee characteristics for Spark vs. Lightning vs. on-chain payments
- Availability and stability of Spark Operators that facilitate the shared signing protocol
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 2 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 114,713 / month, #12,283 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: breez_sdk_spark-0.22.0-cp310-cp310-macosx_11_0_universal2.whl; breez_sdk_spark-0.22.0-cp310-cp310-manylinux_2_31_aarch64.whl; breez_sdk_spark-0.22.0-cp310-cp310-manylinux_2_31_x86_64.whl; breez_sdk_spark-0.22.0-cp310-cp310-win32.whl; breez_sdk_spark-0.22.0-cp310-cp310-win_amd64.whl; breez_sdk_spark-0.22.0-cp311-cp311-macosx_11_0_universal2.whl; breez_sdk_spark-0.22.0-cp311-cp311-manylinux_2_31_aarch64.whl; breez_sdk_spark-0.22.0-cp311-cp311-manylinux_2_31_x86_64.whl; breez_sdk_spark-0.22.0-cp311-cp311-win32.whl; breez_sdk_spark-0.22.0-cp311-cp311-win_amd64.whl; breez_sdk_spark-0.22.0-cp312-cp312-macosx_11_0_universal2.whl; breez_sdk_spark-0.22.0-cp312-cp312-manylinux_2_31_aarch64.whl; breez_sdk_spark-0.22.0-cp312-cp312-manylinux_2_31_x86_64.whl; breez_sdk_spark-0.22.0-cp312-cp312-win32.whl; breez_sdk_spark-0.22.0-cp312-cp312-win_amd64.whl; breez_sdk_spark-0.22.0-cp313-cp313-macosx_11_0_universal2.whl; breez_sdk_spark-0.22.0-cp313-cp313-manylinux_2_31_aarch64.whl; breez_sdk_spark-0.22.0-cp313-cp313-manylinux_2_31_x86_64.whl; breez_sdk_spark-0.22.0-cp313-cp313-win32.whl; breez_sdk_spark-0.22.0-cp313-cp313-win_amd64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “bitcoin lightning payments python”
- breez-sdk-sparkPython bindings for the Breez Spark SDK, enabling non-custodial…
- bech32Encodes and decodes bech32-formatted strings, a checksummed base32…
- python-bitcoinlibProvides low-level Python tools to work with Bitcoin data structures,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Internet packages
Botocore provides low-level, data-driven access to Amazon Web Services APIs, serving as the foundation for the AWS CLI and boto3 libraries.
Install it if you need programmatic access to AWS services.
Provides an async client for AWS services using botocore and aiohttp, allowing you to call AWS APIs asynchronously within asyncio-based applications.
Install it if you need to call AWS services from async Python code; it is the standard way to do so.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides a platform-independent file locking mechanism to coordinate access to files across processes and threads.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides common Protocol Buffer message definitions used across Google Cloud APIs, enabling Python clients to interact with Google services.
See also bech32 · mercadopago · smoldot-light · bitcoin-utils · bip32 · braintree · coincurve · Adyen · python-bitcoinlib