add python

.python-version

@@ -0,0 +1 @@
+d2notebooks-3.12.2

README.md

@@ -0,0 +1,51 @@
+# Setup/Installation
+
+I use [pyenv]() for managing python and installing virtual environments.  On the Mac, it can be installed with homebrew using:
+
+```
+brew update
+brew install pyenv pyenv-virtualenv
+```
+
+and you can add this to your `.zshrc` to get it to automatically load the shims in your terminal with:
+
+```
+if command -v pyenv >/dev/null 2>&1; then
+  export PYENV_ROOT="$HOME/.pyenv"
+  export PATH="$PYENV_ROOT/bin:$PATH"
+  eval "$(pyenv init -)"
+  eval "$(pyenv virtualenv-init -)"
+else
+  echo "missing pyenv, install with:"
+  echo "brew install pyenv"
+  echo "pyenv install 3.12.2"
+fi
+```
+
+Install python and create a new virtual environment for this notebook with:
+
+```
+pyenv install 3.12.2
+
+# make it the global python if desired:
+pyenv global 3.12.2
+
+# create the virtual environment used in .python-version:
+pyenv virtualenv 3.12.2 d2notebooks-3.12.2
+```
+
+Now, when you're in this directory in your shell, you should see this as the active virtualenv:
+
+```
+which python
+/Users/<your user>/.pyenv/shims/python
+
+python -V
+Python 3.12.2
+
+pyenv versions
+  system
+  3.12.2
+  3.12.2/envs/d2notebooks-3.12.2
+* d2notebooks-3.12.2 --> /Users/<your user>/.pyenv/versions/3.12.2/envs/d2notebooks-3.12.2 (set by /Users/<your user>/<path to>/d2notebooks/.python-version)
+```