Skip to content

Commit 7328aff

Browse files
committed
docs: setup readme
1 parent 979e0a9 commit 7328aff

File tree

2 files changed

+11
-62
lines changed

2 files changed

+11
-62
lines changed

README.md

Lines changed: 11 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -1,75 +1,24 @@
1-
# Azure Machine Learning - Automated ML Example
1+
# Jupyter Notebook AI Algorithm Examples
22

3-
[![AzureML](https://a11ybadges.com/badge?logo=microsoft)](https://azure.microsoft.com/en-us/products/machine-learning/)
4-
[![Python](https://a11ybadges.com/badge?logo=python)](https://www.python.org/)<br>
5-
[![Unit Tests](https://github.com/FullStackWithLawrence/ai-algorithms/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/FullStackWithLawrence/ai-algorithms/actions/workflows/test.yml)
6-
![Release Status](https://github.com/FullStackWithLawrence/ai-algorithms/actions/workflows/release.yml/badge.svg?branch=main)
7-
![Auto Assign](https://github.com/FullStackWithLawrence/ai-algorithms/actions/workflows/auto-assign.yml/badge.svg)
3+
[![Python](https://a11ybadges.com/badge?logo=python)](https://www.python.org/)
4+
[![Jupyter](https://a11ybadges.com/badge?logo=jupyter)](https://docs.jupyter.org/en/latest/)<br>
85
[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
96
[![hack.d Lawrence McDaniel](https://img.shields.io/badge/hack.d-Lawrence%20McDaniel-orange.svg)](https://lawrencemcdaniel.com)
107

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:
129

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
1813

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
2015

21-
Note the following:
16+
1. Verify project requirements: [Python 3.13](https://www.python.org/)
2217

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`
2419

25-
## Usage
20+
3. Run `source venv/bin/activate`
2621

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-
```
7322

7423
## Support
7524

jupyter/isolation_forest.pkl

-846 KB
Binary file not shown.

0 commit comments

Comments
 (0)