Bitcoin Safe is a desktop wallet with a focus on great privacy and robustness. I have a special interest in sharing it, as Bitcoin Safe keeps your wallet in sync using compact block filters, via my project Kyoto, along with Bitcoin Dev Kit. Because Bitcoin Safe works with output descriptors, it is incredibly flexible with wallet imports and likely has some future-proofing as a result.

For those unaware, Kyoto is essentially a mini bitcoin node. It does not store anything, but it attempts to follow the chain and fetch information for your wallet. All computation is done on your laptop, achieving near perfect privacy at the cost of some increased bandwidth.

This is a short blog to highlight the great work of Andreas, creator of Bitcoin Safe, and to showcase the culmination of both our work. Indeed, when I set out to make Kyoto, my end goal was a user-facing wallet that was private by default and served all my needs. Thankfully, Andreas was already working on such a solution. Here is how to use it.

Installing from source

Fetch the source code using git:

git clone https://github.com/andreasgriffin/bitcoin-safe.git && cd bitcoin-safe

You will need Python on your system to build Bitcoin Safe.

Install poetry using the recommended installer:

curl -sSL https://install.python-poetry.org | python3 -

Create an environment:

poetry env use "$(command -v python3.13)"

source .venv/bin/activate

Build and launch Bitcoin Safe:

python3 -m pip install poetry && python3 -m poetry install && python3 -m poetry run python3 -m bitcoin_safe

When you are done, you may deactivate the environment:

deactivate

Andreas and I also joined Citadel Dispatch to talk through Bitcoin Safe, Kyoto, and compact block filters in more depth: