diff --git a/README.md b/README.md
index a06a62f..bc4af45 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,21 @@
-# centipede
-Generate a command line interface to any Ethereum smart contract
+# Centipede
+Generate command line and a python interface to any Ethereum smart contract
+
+# Installation
+### pip
+`pip install centipede`
+
+### github
+`git clone https://github.com/bugout-dev/centipede.git`
+
+`cd centipede/`
+
+create virtual env: `python3 -m venv .venv`
+
+activate virtual env: `source .venv/bin/activate`
+
+install: `python3 -m setup.py install`
+
+# Usage
+
+