diff --git a/README.md b/README.md
new file mode 100644
index 0000000..96293cd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,3 @@
+sample client-server pair using gRPC and Qt in Go. The server simply stores an
+integer. The client, when started, automatically connects to the server and,
+once a second, requests the next value in an incrementing counter.