Hardware-based SSH/PGP agent
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Roman Zeyde 4af881b3cb
Split the package into a shared library and separate per-device packages
7 years ago
agents Split the package into a shared library and separate per-device packages 7 years ago
libagent Split the package into a shared library and separate per-device packages 7 years ago
scripts Split the package into a shared library and separate per-device packages 7 years ago
.gitignore gitignore: sublime text project files 8 years ago
.pylintrc fix pylint warnings 7 years ago
.travis.yml Split the package into a shared library and separate per-device packages 7 years ago
LICENSE Initial commit 9 years ago
README-GPG.md README: password manager usage example 7 years ago
README-SSH.md README: add Hg demo 8 years ago
README.md README: upgrade also pip 7 years ago
setup.py Split the package into a shared library and separate per-device packages 7 years ago
tox.ini Split the package into a shared library and separate per-device packages 7 years ago

README.md

Using TREZOR as a hardware SSH/GPG agent

Build Status Python Versions Package Version Development Status Downloads

See SatoshiLabs' blog posts about this feature:

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 -U setuptools pip
$ pip install Cython 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 (if pip doesn't work for you):

$ git clone https://github.com/romanz/trezor-agent && cd trezor-agent
$ python setup.py build && python setup.py install

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

If you have an error regarding protobuf imports (after installing it), please see this issue.

Usage

For SSH, see the following instructions (for Windows support, see trezor-ssh-agent project (by Martin Lízner)).

For GPG, see the following instructions.

See here for PIN entering instructions.

Troubleshooting

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

Gitter

Questions, suggestions and discussions are welcome: Chat