diff --git a/docs/environment.yml b/docs/environment.yml
new file mode 100644
index 0000000..a60f92c
--- /dev/null
+++ b/docs/environment.yml
@@ -0,0 +1,9 @@
+name: black_docs
+channels:
+  - conda-forge
+dependencies:
+- python>=3.6
+- Sphinx==1.7.2
+- pip:
+  - recommonmark==0.4.0
+  - git+https://git@github.com/ambv/black.git
diff --git a/readthedocs.yml b/readthedocs.yml
new file mode 100644
index 0000000..bd33c28
--- /dev/null
+++ b/readthedocs.yml
@@ -0,0 +1,6 @@
+name: jupyterhub
+type: sphinx
+conda:
+    file: docs/environment.yml
+python:
+  version: 3