diff --git a/gui/README.md b/gui/README.md
new file mode 100644
index 0000000..c3b9a22
--- /dev/null
+++ b/gui/README.md
@@ -0,0 +1,33 @@
+
+# eosio-keygen (gui)
+
+This is the graphical version of [eosio-keygen](https://github.com/eosswedenorg/eosio-keygen) project.
+
+The program generates public and private keypairs for [EOSIO](https://eos.io/)
+
+Among the basic functionality the program can also search for keys containing specific words also know as _vanity keys_.
+
+## Security notice
+
+Keys are generated by `OpenSSL`'s `EC_KEY_generate_key` function. The program will
+never expose your keys to anything but the computers memory and output of the
+program. You are free to inspect the source code and compile yourself to verify.
+
+However, use this at your own risk. we cannot guarantee that the keys are
+cryptographically secure as this depends on OpenSSL's implementation (alto it is
+widely used and should be safe)
+
+Please read the `LICENSE.gui` file.
+
+```
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
+OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+## Author
+
+Henrik Hautakoski - [henrik@eossweden.org](mailto:henrik@eossweden.org)