trezor-agent/INSTALL.md

Installation

Install the following packages (depending on your distribution):

Debian

$ apt update && apt upgrade
$ apt install python-pip python-dev libusb-1.0-0-dev libudev-dev

Fedora/RedHat

$ yum update
$ yum install python-pip python-devel libusb-devel libudev-devel \
              gcc redhat-rpm-config

Also, update Python packages before starting the installation:

$ pip install -U setuptools pip

Make sure you are running the latest firmware version on your hardware device. Currently the following firmware versions are supported:

• TREZOR: 1.4.2+
• KeepKey: 3.0.17+
• Ledger Nano S: 0.0.3+ (install SSH/PGP Agent app)

TREZOR

Make sure that your udev rules are configured correctly. Then, install the latest trezor_agent package:

$ pip install trezor_agent

Or, directly from the latest source code:

$ git clone https://github.com/romanz/trezor-agent
$ pip install --user -e trezor-agent/agents/trezor

KeepKey

Make sure that your udev rules are configured correctly. Then, install the latest keepkey_agent package:

$ pip install keepkey_agent

Or, directly from the latest source code:

$ git clone https://github.com/romanz/trezor-agent
$ pip install --user -e trezor-agent/agents/keepkey

Ledger Nano S

Make sure that your udev rules are configured correctly. Then, install the latest ledger_agent package:

$ pip install ledger_agent

Or, directly from the latest source code:

$ git clone https://github.com/romanz/trezor-agent
$ pip install --user -e trezor-agent/agents/ledger

Troubleshooting

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

If you can't find the command-line utilities (after running pip install --user), please make sure that ~/.local/bin is on your PATH variable (see a relevant issue).