TODO: Insert Overview Here
TODO: Insert Design Here
- Linux (Ubuntu).
- Anaconda Python
- Docker installed.
- Azure account.
NOTE You will need to be able to run docker commands without sudo to run this tutorial. Use the following commands to do this.
sudo usermod -aG docker $USER
newgrp docker
The tutorial was developed on an Azure Ubuntu DSVM, which addresses the first three prerequisites.
To set up your environment to run these notebooks, please follow these steps. They setup the notebooks to use Azure seamlessly.
- Create a Linux Ubuntu VM.
- Copy
sample_workspace_conf.yml
to a new file,workspace_conf.yml
, and fill in each field. This will keep secrets out of the source code, and this file will be ignored by git. - Log in to your VM. We recommend that you use a graphical client such as X2Go to access your VM. The remaining steps are to be done on the VM.
- Open a terminal emulator.
- Clone, fork, or download the zip file for this repository:
git clone https://github.com/Microsoft/ai-architecture-template.git
- Enter the local repository:
cd ai-architecture-template
- Create the Python ai-architecture-template virtual environment using the environment.yml:
conda env create -f environment.yml
- Activate the virtual environment:
The remaining steps should be done in this virtual environment.
source activate ai-architecture-template
- Login to Azure:
You can verify that you are logged in to your subscription by executing the command:
az login
az account show -o table
- If you have more than one Azure subscription, select it:
az account set --subscription <Your Azure Subscription>
- Start the Jupyter notebook server:
jupyter notebook
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.
Microsoft AI Github Find other Best Practice projects, and Azure AI Designed patterns in our central repository.