trezor-agent/doc/INSTALL.md

Installation

1. Prerequisites

Install the following packages (depending on your distribution):

OS dependencies

This software needs Python, libusb, and libudev along with development files.

You can install them on these distributions as follows:

Debian

$ apt install python-pip python-dev python-tk libusb-1.0-0-dev libudev-dev

Fedora/RedHat

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

OpenSUSE

$ zypper install python-pip python-devel python-tk libusb-1_0-devel libudev-devel

If you are using python3 or your system pip command points to pip3.x (/etc/alternatives/pip -> /usr/bin/pip3.6) you will need to install these dependencies instead:

$ zypper install python3-pip python3-devel python3-tk libusb-1_0-devel libudev-devel

GPG

If you intend to use GPG make sure you have GPG installed and up to date. This software requires a GPG version >= 2.1.11.

You can verify your installed version by running:

$ gpg2 --version | head -n1
gpg (GnuPG) 2.1.15

• Follow this installation guide for Debian
• Install GPG for macOS
• Install packages for Ubuntu 16.04 here
• Install packages for Linux Mint 18 here

2. Install the TREZOR agent

1. Make sure you are running the latest firmware version on your Trezor:

• TREZOR firmware releases: 1.4.2+

2. Make sure that your udev rules are configured correctly.

3. 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
   

   Read these instructions on how to enter your PIN with the PIN entry.

3. Install the KeepKey agent

1. Make sure you are running the latest firmware version on your KeepKey:

• KeepKey firmware releases: 3.0.17+

2. 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
   

4. Install the Ledger Nano S agent

1. Make sure you are running the latest firmware version on your Ledger Nano S:

• Ledger Nano S firmware releases: 0.0.3+ (install SSH/PGP Agent app)

2. Make sure that your udev rules are configured correctly.

3. 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
   

5. Installation 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).

If you can't find command-line utilities and are on macOS/OSX check ~/Library/Python/2.7/bin and add to PATH if necessary (see a relevant issue).