Python library and command-line client for communicating with Trezor Hardware Wallet.
See https://trezor.io for more information.
Python Trezor tools require Python 3.5 or higher, and libusb 1.0. The easiest
way to install it is with
pip. The rest of this guide assumes you have
pip; if not, you can refer to this
On a typical system, you already have all you need. Install
pip3 install trezor
Current trezorlib version supports Trezor One version 1.8.0 and up, and Trezor T version 2.1.0 and up.
For firmware versions below 1.8.0 and 2.1.0 respectively, the only supported operation is "upgrade firmware".
Trezor One with firmware older than 1.7.0 (including firmware-less out-of-the-box units) will not be recognized, unless you install HIDAPI support (see below).
Firmware-less Trezor One: If you are setting up a brand new Trezor One without firmware, you will need HIDAPI support. On Linux, you will need the following packages (or their equivalents) as prerequisites:
pip3 install trezor[hidapi]
Ethereum: To support Ethereum signing from command line, additional packages are needed. Install with:
pip3 install trezor[ethereum]
To install both, use
pip3 install trezor[hidapi,ethereum].
Check out Repology to see if your operating system has an up-to-date python-trezor package.
pip3 install "git+https://github.com/trezor/trezor-firmware#egg=trezor&subdirectory=python"
Install the Poetry tool, checkout
trezor-firmware from git, and enter the poetry shell:
pip3 install poetry git clone https://github.com/trezor/trezor-firmware cd trezor-firmware poetry install poetry shell
In this environment, trezorlib and the
trezorctl tool is running from the live
sources, so your changes are immediately effective.
trezorctl python script can perform various tasks such as
changing setting in the Trezor, signing transactions, retrieving account
info and addresses. See the docs/ sub folder for detailed
examples and options.
You can use this python library to interact with a Trezor and use its capabilities in your application. See examples here in the tools/ sub folder.
When you are asked for PIN, you have to enter scrambled PIN. Follow the numbers shown on Trezor display and enter the their positions using the numeric keyboard mapping:
Example: your PIN is 1234 and Trezor is displaying the following:
You have to enter: 3795
If you want to change protobuf or coin definitions, you will need to regenerate
definitions in the
First, make sure your submodules are up-to-date with:
git submodule update --init --recursive
Then, rebuild the protobuf messages by running, from the
To get support for BTC-like coins, these steps are enough and no further changes to the library are necessary.