diff --git a/README.md b/README.md
new file mode 100644
index 0000000..aea10ed
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# This is an ComfyUI implementation of [Motion Vector Extractor](https://github.com/LukasBommes/mv-extractor)
+
+## Install
+
+1. Clone this repo into custom_nodes directory of ComfyUI location
+
+2. Run
+```
+pip install --upgrade pip
+pip install motion-vector-extractor
+```
+
+Note, that we currently provide the package only for x86-64 linux, such as Ubuntu or Debian, and Python 3.8, 3.9, and 3.10.
+
+## Examples
+
+1. base workflow
+
+<img src="assets/wf_base.png" raw=true>
+
+https://github.com/chaojie/ComfyUI-Motion-Vector-Extractor/blob/main/workflow.json
diff --git a/wf_base.png b/wf_base.png
new file mode 100644
index 0000000..8ca98fb
Binary files /dev/null and b/wf_base.png differ