diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bed0ee8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,44 @@
+# Thalos
+
+Thalos is a application that makes it easy for users to stream blockchain data from an Antelope SHIP node.
+
+It handles all the technical stuff for you:
+
+ * Decoding of antelope's binary format.
+ * Websocket connection (with reconnection)
+ * Decoding of action data according to contract ABI
+
+And then sends the data over redis in plain json (or other popular formats if you want!)
+
+## Compiling
+
+You will need golang version `1.18` or later to compile the source.
+
+Compile using make:
+
+```shell
+$ make
+```
+
+or using go directly if you dont have make installed.
+
+```shell
+$ go build -o build/thalos-server cmd/main/main.go
+```
+
+
+## Install
+
+After compiling the binary, you can install it along with basic config file and start/stop scripts using `install.sh`
+
+```shell
+$ ./install.sh /path/to/your/directory/of/choice
+```
+
+## Runtime dependencies
+
+Make sure `redis` is installed as thalos uses it for both cache and message broker.
+
+## Author
+
+Henrik Hautakoski - [henrik@eossweden.org](mailto:henrik@eossweden.org)
\ No newline at end of file