trezor-agent/README.md

Using TREZOR as a hardware SSH/GPG agent

See SatoshiLabs' blog posts about this feature:

• TREZOR Firmware 1.3.4 enables SSH login
• TREZOR Firmware 1.3.6 — GPG Signing, SSH Login Updates and Advanced Transaction Features for Segwit

Installation

First, make sure that the latest trezorlib Python package is installed correctly (at least v0.6.6):

$ apt-get install python-dev libusb-1.0-0-dev libudev-dev
$ pip install Cython trezor
$ pip install -U setuptools

Then, install the latest trezor_agent package:

$ pip install trezor_agent

Finally, verify that you are running the latest TREZOR firmware version (at least v1.4.0):

$ trezorctl get_features | head
vendor: "bitcointrezor.com"
major_version: 1
minor_version: 4
patch_version: 0
...

Usage

For SSH, see the following instructions.

For GPG, see the following instructions.

Questions, suggestions and discussions are welcome:

Troubleshooting

If there is an import problem with the installed protobuf package, see this issue for fixing it.