|
1 | | -# Azure Machine Learning - Automated ML Example |
| 1 | +# Jupyter Notebook AI Algorithm Examples |
2 | 2 |
|
3 | | -[](https://azure.microsoft.com/en-us/products/machine-learning/) |
4 | | -[](https://www.python.org/)<br> |
5 | | -[](https://github.com/FullStackWithLawrence/ai-algorithms/actions/workflows/test.yml) |
6 | | - |
7 | | - |
| 3 | +[](https://www.python.org/) |
| 4 | +[](https://docs.jupyter.org/en/latest/)<br> |
8 | 5 | [](https://www.gnu.org/licenses/agpl-3.0) |
9 | 6 | [](https://lawrencemcdaniel.com) |
10 | 7 |
|
11 | | -Demonstrate basic usage of Azure Machine Learning's [Automated ML](https://azure.microsoft.com/en-us/solutions/automated-machine-learning) service. Implements the following: |
| 8 | +Demonstrate basic AI algorithms implemented using Python, including: |
12 | 9 |
|
13 | | -- `AzureAIMLWorkspace`: Azure AI ML Studio workspace helper class. generates an authenticated instance of a workspace. |
14 | | -- `AzureAIMLAssetsDataset`: Azure AI ML Studio data set. Provides helpers for managing ML Studio data sets, and for porting to/from kaggle data sets and local csv and Excel files. |
15 | | -- `AzureAIMLStudioComputeCluster`: Azure AI ML Studio Compute - compute cluster object with helpers for instantitation. |
16 | | -- `AzureAIMLStudioAssetsBatchEndpoint`: Azure AI ML Studio Assets - batch end point. Providers helpers for managing end points. |
17 | | -- `AzureAIMLStudioAuthoringAutomatedML`: Azure AI ML Studio Authoring - Automated ML. Helper class for managing life cycle of 'automated ml' jobs. |
| 10 | +- Anomaly Detection: credit card detection using data from Kaggle |
| 11 | +- Regression: House price forecasting tool using data from Kaggle |
| 12 | +- K-Means: Cluster example using the Iris dataset from Kaggle |
18 | 13 |
|
19 | | -There is also an [example production deployment](./titanic-survival-app/) of a model created using AutomatedML. See important deployment details, [here](./docs/AZURE_DEPLOYMENT.md). |
| 14 | +## Quickstart |
20 | 15 |
|
21 | | -Note the following: |
| 16 | +1. Verify project requirements: [Python 3.13](https://www.python.org/) |
22 | 17 |
|
23 | | -3. This project leverages [Github Actions](https://github.com/features/actions) for automated unit tests, build, deploy, in addition to automating various administrative tasks including for example, automating updates to 3rd party package requirements. Most of these are visible from the [Actions](https://github.com/FullStackWithLawrence/ai-algorithms/actions) tab above. |
| 18 | +2. Run `make init` |
24 | 19 |
|
25 | | -## Usage |
| 20 | +3. Run `source venv/bin/activate` |
26 | 21 |
|
27 | | -```console |
28 | | -python3 -m azure_ai.commands.help |
29 | | -python3 -m azure_ai.commands.workspace |
30 | | -python3 -m azure_ai.commands.compute_cluster cluster-name |
31 | | -python3 -m azure_ai.commands.dataset_from_file maths ~/Desktop/gh/fswl/ai-algorithms/azure_ai/tests/data/maths.csv |
32 | | -python3 -m azure_ai.commands.dataset_from_kaggle titanic heptapod/titanic |
33 | | -``` |
34 | | - |
35 | | -## Setup |
36 | | - |
37 | | -Works with Linux, Windows and macOS environments. |
38 | | - |
39 | | -1. Verify project requirements: [Python 3.13](https://www.python.org/), [NPM](https://www.npmjs.com/) [Docker](https://www.docker.com/products/docker-desktop/), and [Docker Compose](https://docs.docker.com/compose/install/). Docker will need around 1 vCPU, 2Gib memory, and 30Gib of storage space. |
40 | | - |
41 | | -2. Run `make` and add your credentials to the newly created `.env` file in the root of the repo. |
42 | | - |
43 | | -3. Create an Azure account. See this summary for account configuration important details that you'll need to address in order for Azure AI AutomatedML batch jobs to run correctly: [Azure Account Setup for AutoML](./docs/AZURE_ACCOUNT_SETUP.md) |
44 | | - |
45 | | -4. Add your Azure `config.json` to the root of this project. See [Azure ML Configuration Guide](./docs/AZURE_ML_CONFIG.md) for detailed instructions on setting up an Azure Workspace and Subscription, and downloading your `config.json` file. |
46 | | - |
47 | | -5. Add your Kaggle Api key to [.kaggle/kaggle.json](./.kaggle/kaggle.json), which you can generate from [https://www.kaggle.com/settings/account](https://www.kaggle.com/settings/account). |
48 | | - |
49 | | -6. Install and configure Azure cli. On Mac `brew install azure-cli`. On Windows download from [https://aka.ms/installazurecliwindows](https://aka.ms/installazurecliwindows). |
50 | | - |
51 | | - - `az login` |
52 | | - - `az account list --output table` |
53 | | - - `az account set --subscription "your-subscription-id-or-name"` |
54 | | - |
55 | | -7. Initialize, build and run the application locally. |
56 | | - |
57 | | -```console |
58 | | -git clone https://github.com/FullStackWithLawrence/ai-algorithms.git |
59 | | -make # scaffold a .env file in the root of the repo |
60 | | - # |
61 | | - # **************************** |
62 | | - # STOP HERE! |
63 | | - # **************************** |
64 | | - # Review your .env file located in the project root folder. |
65 | | - # |
66 | | -make init # Initialize Python virtual environment used for code auto-completion and linting |
67 | | -make test # Verify that your Python virtual environment was built correctly and that |
68 | | - # azureml.core finds your config.json file. |
69 | | - # |
70 | | -make docker-build # Build and configure all docker containers |
71 | | -make docker-run # Run docker container |
72 | | -``` |
73 | 22 |
|
74 | 23 | ## Support |
75 | 24 |
|
|
0 commit comments