diff --git a/NBSETUP.md b/NBSETUP.md index 8cebb5f8..4c9fdffa 100644 --- a/NBSETUP.md +++ b/NBSETUP.md @@ -4,7 +4,8 @@ To run the notebooks in this repository use one of these methods: -## Use Azure Notebooks - Jupyter based notebooks in the Azure cloud +## Option 1: Use Azure Notebooks +Azure Notebooks is a hosted Jupyter-based notebook service in the Azure cloud. Azure Machine Learning Python SDK is already pre-installed in the Azure Notebooks `Python 3.6` kernel. 1. [![Azure Notebooks](https://notebooks.azure.com/launch.png)](https://aka.ms/aml-clone-azure-notebooks) [Import sample notebooks ](https://aka.ms/aml-clone-azure-notebooks) into Azure Notebooks @@ -15,20 +16,36 @@ To run the notebooks in this repository use one of these methods: ![set kernel to Python 3.6](images/python36.png) -## **Use your own notebook server** +## **Option 2: Use your own notebook server** +```sh +# install just the base SDK +pip install azureml-sdk -Video walkthrough: +# install the base SDK and a Jupyter notebook server +pip install azureml-sdk[notebooks] + +# install the data prep component +pip install azureml-dataprep + +# install model explainability component +pip install azureml-sdk[explain] + +# install automated ml components +pip install azureml-sdk[automl] + +# install experimental features (not ready for production use) +pip install azureml-sdk[contrib] + +# clone the sample repoistory +git clone https://github.com/Azure/MachineLearningNotebooks.git +``` + +### Full instructions +[install the Azure Machine Learning SDK](https://docs.microsoft.com/en-us/azure/machine-learning/service/quickstart-create-workspace-with-python) + +Please make sure you start with the [Configuration](configuration.ipynb) notebook to create and connect to a workspace. + + +### Video walkthrough: [![Get Started video](images/yt_cover.png)](https://youtu.be/VIsXeTuW3FU) - -1. Setup a Jupyter Notebook server and [install the Azure Machine Learning SDK](https://docs.microsoft.com/en-us/azure/machine-learning/service/quickstart-create-workspace-with-python) -1. Clone [this repository](https://aka.ms/aml-notebooks) -1. You may need to install other packages for specific notebook - - For example, to run the Azure Machine Learning Data Prep notebooks, install the extra dataprep SDK: - ```bash - pip install azureml-dataprep - ``` - -1. Start your notebook server -1. Follow the instructions in the [Configuration](configuration.ipynb) notebook to create and connect to a workspace -1. Open one of the sample notebooks