Installing Brownie

The easiest way to install Brownie is via pip.

$ pip install eth-brownie

You can also clone the github repository and use setuptools for the most up-to-date version.

$ python3 install

Once you have installed, type brownie to verify that it worked:

$ brownie
Brownie - Python development framework for Ethereum

Usage:  brownie <command> [<args>...] [options <args>]


Brownie has the following dependencies:

As brownie relies on py-solc-x, you do not need solc installed locally but you must install all required solc dependencies.


The Brownie GUI is built using the Tk GUI toolkit. Both Tk and tkinter are available on most Unix platforms, as well as on Windows systems.

Tk is not a strict dependency for Brownie. However, if it is not installed on your system you will receive an error when attempting to load the GUI.

You can use the following command to check that Tk has been correctly installed:

$ python -m tkinter

This should open a simple window and display the installed version number.

For installation instructions read Installing TK within the TK Documentation.