diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..38042cb
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,9 @@
+[submodule "quantum-tunnel"]
+	path = quantum-tunnel
+	url = https://github.com/ChorusOne/quantum-tunnel.git
+[submodule "wormhole"]
+	path = wormhole
+	url = https://github.com/ChorusOne/wormhole.git
+[submodule "gaia"]
+	path = gaia
+	url = https://github.com/ChorusOne/gaia.git
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4068c88
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# Wormhole: A Cosmos-Substrate bridge
+
+## What is Wormhole?
+
+Wormhole is a bridge to connect a Substrate-based blockchain to a Cosmos-SDK based blockchain. It is based around a 
+
+## Parts
+
+The Wormhole bridge, comprises three parts:
+  - A fork of Gaia, with an additional module to allow execution of wasm-based light clients.
+  - Wormhole, a Substrate-based chain, including a tendermint-client pallet.
+  - Quantum-tunnel, a simple relayer, written in rust.
+
+## Demo
+
+In order to run the demo, clone this repository, and run `docker-compose up`.
+
+
+## Credit and Attribution
+
+Substrate - Web3 Foundation, Parity
+Cosmos-SDK - All in Bits, Tendermint Inc., Interchain.io, Interchain Foundation
+Cosmwasm - Confio, Ethan Frey and Simon Warta
+Tendermint-rs - Informal Systems
+Concept of Wasm-based light client - Zaki Manian, Iqclusion
+
+
diff --git a/docker-compose.yaml b/docker-compose.yaml
new file mode 100644
index 0000000..688a23c
--- /dev/null
+++ b/docker-compose.yaml
@@ -0,0 +1,20 @@
+version: '3.4'
+services:
+  gaia:
+    image: gaia
+    build:
+      context: ./gaia
+    command: gaiad start
+  lcd:
+    image: gaia
+    command: gaiacli rest-server
+  qt:
+    image: quantum-tunnel
+    build:
+      context: ./quantum-tunnel
+  wormhole:
+    image: wormhole
+    build:
+      context: ./wormhole
+    command: wormhole start --dev
+   
diff --git a/gaia b/gaia
new file mode 160000
index 0000000..a88a62b
--- /dev/null
+++ b/gaia
@@ -0,0 +1 @@
+Subproject commit a88a62bde2a6dac91c24d3ea251850e6d659cc92
diff --git a/quantum-tunnel b/quantum-tunnel
new file mode 160000
index 0000000..65507a1
--- /dev/null
+++ b/quantum-tunnel
@@ -0,0 +1 @@
+Subproject commit 65507a1dca713c29d4a7b875a67a481e36978898
diff --git a/wormhole b/wormhole
new file mode 160000
index 0000000..e6b9716
--- /dev/null
+++ b/wormhole
@@ -0,0 +1 @@
+Subproject commit e6b9716456a9f27a3fe35800455b8b4891c84a5b