diff --git a/README.md b/README.md
index a6267d7ff..ff583e577 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,46 @@
 [![Build Status](https://travis-ci.org/status-im/nim-libp2p.svg?branch=master)](https://travis-ci.org/status-im/nim-libp2p)
 [![Build status](https://ci.appveyor.com/api/projects/status/pqgif5bcie6cp3wi/branch/master?svg=true)](https://ci.appveyor.com/project/nimbus/nim-libp2p/branch/master)
 
-libp2p implementation in Nim
+## Introduction
+
+An implementation of [libp2p](https://libp2p.io/) in Nim, as a wrapper of the [Libp2p Go daemon](https://github.com/libp2p/go-libp2p).
+
+Note that you need Go 1.12+ for the below instructions to work!
+
+Install dependencies and run tests with:
+
+```bash
+nimble install
+nimble test
+git submodule update --init --recursive
+go version
+git clone https://github.com/libp2p/go-libp2p-daemon
+cd go-libp2p-daemon
+git checkout v0.0.1
+go install ./...
+cd ..
+```
+
+Try out the chat example:
+
+```bash
+nim c -r --threads:on examples\chat.nim
+```
+
+This will output a peer ID such as `QmbmHfVvouKammmQDJck4hz33WvVktNEe7pasxz2HgseRu` which you can use in another instance to connect to it.
+
+```bash
+./example/chat
+/connect QmbmHfVvouKammmQDJck4hz33WvVktNEe7pasxz2HgseRu
+```
+
+You can now chat between the instances!
+
+![Chat example](https://imgur.com/caYRu8K.gif)
+
+## API
+
+Coming soon...
 
 ## License