diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2113c1f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,28 @@
+# .vim
+
+Config files for vim.
+
+## Requirements
+
+- neovim `brew install neovim` (mac) `apt-get install neovim` (ubuntu)
+- python 3
+- pynvim `pip install pynvim`
+
+## QuickStart
+
+```bash
+cd ${HOME};
+git clone "https://git.gregoryleeman.com/gregory/.vim.git";
+mkdir -p "${HOME}/.config/nvim";
+cat > "${HOME}/.config/nvim/init.vim" << EOF
+set runtimepath^=~/.vim runtimepath+=~/.vim/after
+let &packpath = &runtimepath
+source ~/.vim/vimrc
+EOF
+```
+
+Inside vim, run:
+
+```
+:PlugInstall
+```