diff --git a/docs/environment.yml b/docs/environment.yml
new file mode 100644
index 0000000..3ccce04
--- /dev/null
+++ b/docs/environment.yml
@@ -0,0 +1,11 @@
+name: ipython_docs
+dependencies:
+- python=3.6
+- setuptools>=18.5
+- sphinx>=1.8
+- sphinx_rtd_theme
+- pip:
+    - docrepr
+    - prompt_toolkit
+    - ipython
+    - ipykernel
diff --git a/readthedocs.yml b/readthedocs.yml
new file mode 100644
index 0000000..b9eadb8
--- /dev/null
+++ b/readthedocs.yml
@@ -0,0 +1,4 @@
+conda:
+    file: docs/environment.yml
+python:
+    version: 3