Skip to content

Commit f3e5668

Browse files
authored
Update README.md
1 parent 58616e9 commit f3e5668

1 file changed

Lines changed: 11 additions & 2 deletions

File tree

README.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,24 @@
33
## When to use?
44
After you create an algorithm on Algorithmia as the scalable inference endpoint for your ML model, you can incorporate this Github Action to your Github ML repository's workflow file, to automate deploying your model and your inference (algorithm) code.
55

6-
This action would be a good fit for your workflow if you are using a Jupyter notebook to train and evaluate your ML model or checking your saved model file into your repository and you have your inference (algorithm) script & dependencies in your ML repo. The Github Action will get deploy your model file to a data collection at Algorithmia and create a new build for your inference endpoint to use the new model, whenever you do a Git push to your master branch (or any other triggering event you configure).
6+
This action would be a good fit for your workflow if you are using a Jupyter notebook to train and evaluate your ML model or checking your saved model file into your repository and you have your inference (algorithm) script & dependencies in your ML repo.
7+
78

89
## How does it work?
910

11+
The Github Action will get deploy your model file to a data collection at Algorithmia and create a new build for your inference endpoint to use the new model, whenever you do a Git push to your master branch (or any other triggering event you configure).
12+
13+
![](images/overview.png)
14+
1015
Depending on your model development preference:
1116

12-
If you're developing your ML model on a Jupyter notebook, you can configure the workflow with the notebook path and tell it where to save the model file. In this case, the workflow will run the notebook on the CI worker machine's from-scratch environment. Through our utility script, your notebook will get the path for where to save the ML model object.
17+
If you're developing your ML model on a Jupyter notebook, you can configure the workflow with the notebook path and tell it where to save the model file. In this case, the workflow will run the notebook on the CI worker machine's from-scratch environment.
1318
If you have an already saved model checked-in to your repository, you can configure the workflow with the existing model file path.
1419

1520
In both scenarios, the workflow will get the model file and upload it to the configured data collection on Algorithmia.
1621

22+
![](images/flowchart.png)
23+
1724
## What other perks does it have?
1825
To get your inference endpoint use this newly uploaded model, the workflow will make the connection between your inference algorithm and the uploaded model file, with the key-value pairs in `model_manifest.json` file.
1926
In addition to that, the manifest file will contain certain metadata such as:
@@ -24,6 +31,8 @@ In addition to that, the manifest file will contain certain metadata such as:
2431

2532
By using this manifest, your inference script will know which model to load and use. It can also calculate the loaded model file's MD5 hash with the original MD5 hash that was calculated at the time of the upload, and make sure that the model file hasn't been changed.
2633

34+
![](model_manifest.png)
35+
2736
## How is it configured?
2837

2938
The inputs to this Github Action is as follows. Please check the default values of some of them, and make sure to include them in your own ML repo's workflow file if you want a non-default configuration for these.

0 commit comments

Comments
 (0)