by adamyala

An up to date and bare minimum tutorial on deploying smart contracts with python

132 Stars 25 Forks Last release: Not found MIT License 32 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


This code borrows heavily from llSourcell's turtorial which in turn borrows heavily from maheshmurthy's tutorial.

Please head over to each and toss a star on the repositories. Both of them created a wonderful tutorials to learn from.


We will be building a decentralized voting application!

The functionality of this repo is nearly identical to llSourcell's but the entire implementation is done in python!



  • Python 3.6+
  • Solidity 4.23+
  • Node.js 9.8+


  1. Create and activate a virtual environment
  2. Install dependencies with
    pip install -r requirements.txt
  3. Install the ganache-cli command line tool with
    npm install -g ganache-cli
    1. What does this cli do? It runs an ethereum node locally. Normally we'd have to download a lot of blockchain transactions and run a test ethereum node locally. This tool lets us run a small local node for easy peasey development. This tool used to be called the
    2. Uh... This tool isn't python... True, but I have found the JavaScript tooling for testrpc to be fantastic and easy to use. If you don't want to bother with
      or just want to try out a full python stack, try out eth-testrpc. It's pip installable but not as maintained as


Open up two tabs. In the first tab run

. This will start a block chain locally that we can play with.

In the second tab activate your virtual environment and run
. This will start our little flask app in debug mode, deploying our contract in the process.

After the python file runs you should see something like:

  Transaction: 0xd3d96eb1d0b8ca8b327d0eca60ff405d0000c5cd249d06712877effbcf73095f
  Contract created: 0x9e4fab9629b8768730d107ae909567974c4c8e35
  Gas usage: 352112
  Block Number: 1
  Block Time: Sat Dec 23 2017 22:31:13 GMT+0200 (SAST)
in the first tab. This is your contract being deployed to the chain on your local node!
is where the bulk of our logic happens. It deploys our smart contract to our test ethereum node and starts serving our flask app.
are heavily commented so please give those a read to understand what each is doing.

Next open in your browser of choice. The web application will connect to our deployed contract and use it as the backend.

Congrats! You setup your first decentralized application with python!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.