Skip to main content

Python toolkit for Tezos

Project description


PyPI version Tests Docker Build Status Made With License: MIT

Python SDK for Tezos:

  • RPC query engine
  • Cryptography
  • Building and parsing operations
  • Smart contract interaction
  • Local forging/packing & vice versa
  • Working with Michelson AST

PyTezos CLI:

  • Generating contract parameter/storage schema
  • Activating and revealing accounts
  • Deploying contracts (+ GitHub integration)

Michelson REPL:

  • Builtin interpreter (reimplemented)
  • Set of extra helpers (stack visualization, blockchain context mocking)

Michelson integration testing framework:

  • Writing integration tests using unittest package
  • Simulating contract execution using remote intepreter (via RPC) or builtin one


  • git
  • python 3.6+
  • pip 19.0.1+

You will also probably need to install several cryptographic packets.


Use apt or your favourite package manager:

$ sudo apt install libsodium-dev libsecp256k1-dev libgmp-dev


Use homebrew:

$ brew tap cuber/homebrew-libsecp256k1
$ brew install libsodium libsecp256k1 gmp


The recommended way is to use WSL and then follow the instructions for Linux, but if you feel lucky you can try to install natively:

  1. Install MinGW from
  2. Make sure C:\MinGW\bin is added to your PATH
  3. Download the latest from
  4. Extract the Win64/Release/v143/dynamic/libsodium.dll from the zip file
  5. Copy libsodium.dll to C:\Windows\System32\libsodium.dll


$ pip install pytezos

Google Colab

>>> !apt install libsodium-dev libsecp256k1-dev libgmp-dev
>>> !pip install pytezos

Docker container

Verified & minified images for CI/CD

docker pull bakingbad/pytezos

Quick start

Read quick start guide

API reference

Check out a complete API reference

Inline documentation

If you are working in Jupyter/Google Colab or any other interactive console, you can display documentation for a particular class/method:

>>> from pytezos import pytezos
>>> pytezos
<pytezos.client.PyTezosClient object at 0x7f904cf339e8>

.key  # tz1grSQDByRpnVs7sPtaprNZRp531ZKz6Jmm
.shell  # (alphanet)



Additional materials

Michelson test samples



The project was initially started by Arthur Breitman, now it's maintained by Baking Bad team. PyTezos development is supported by Tezos Foundation.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pytezos, version 2.5.13
Filename, size File type Python version Upload date Hashes
Filename, size pytezos-2.5.13-py3-none-any.whl (106.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pytezos-2.5.13.tar.gz (90.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page