diff --git a/README.md b/README.md
index dc1b2a5..477eb40 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,43 @@
 # ux-mediapipe
-Rust and mediapipe
 
-bazel build --define MEDIAPIPE_DISABLE_GPU=1 mediapipe:mediagraph
\ No newline at end of file
+Rust and mediapipe.
+
+Mediapipe is a framework for building AI-powered computer vision and augmented reality applications. It provides high level libraries exposing some of its solutions for common problems. This package makes some of these solutions available in Rust. In order to use it we must build a C++ library that provides an interface to the mediapipe 'engine'.
+
+Figuring all this out has been a challenge. I have made these forks and instructions to help me in the future. There are a number of improvements I'd like to make when I have the time.
+
+## requirements
+
+- bazel
+- clang
+
+## setup
+
+Clone the modified Mediapipe repo:
+
+```shell
+git clone https://github.com/julesyoungberg/mediapipe.git
+cd mediapipe
+```
+
+Build & install the mediagraph library.
+
+### mac os
+
+```shell
+bazel build --define MEDIAPIPE_DISABLE_GPU=1 mediapipe:libmediagraph.dylib
+sudo cp bazel-bin/mediapipe/libmediagraph.dylib /usr/local/lib/libmediagraph.dylib
+cp mediapipe/cpuhost.h /usr/local/include/mediagraph.h
+```
+
+### linux (untested)
+
+```shell
+bazel build --define MEDIAPIPE_DISABLE_GPU=1 mediapipe:mediagraph
+cp bazel-bin/mediapipe/libmediagraph.so /usr/local/lib/libmediagraph.so
+cp mediapipe/cpuhost.h /usr/local/include/mediagraph.h
+```
+
+## binding generation
+
+The binding generation should be automated. Currently it is a combination of manual commands and manual file editing...not ideal.