From 930c4cf15dd687eca88b0690bd3c2cbc61cc6a78 Mon Sep 17 00:00:00 2001 From: iwantanode <87604944+tudorpintea999@users.noreply.github.com> Date: Wed, 13 Dec 2023 06:35:10 +0200 Subject: [PATCH 01/11] minor typos full_transpilation.md --- docs/examples/full_transpilation.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/examples/full_transpilation.md b/docs/examples/full_transpilation.md index 8b470a1..1eef394 100644 --- a/docs/examples/full_transpilation.md +++ b/docs/examples/full_transpilation.md @@ -121,7 +121,7 @@ class Net(nn.Module): return F.log_softmax(x, dim=1) ``` -Now lets instantiate the model and define the optimizer: +Now let's instantiate the model and define the optimizer: ```python @@ -276,13 +276,13 @@ Enter your email 📧: # YOUR EMAIL GOES HERE [giza][2023-10-12 12:04:13.875] User created ✅. Check for a verification email 📧 ``` -You will be prompted to add tour username, password and email. Finally you will need to verify your email address by clicking on the link that you will receive in your inbox. +You will be prompted to add your username, password and email. Finally you will need to verify your email address by clicking on the link that you will receive in your inbox. ![email](img/email.png) Once we click the link we will be redirected to a verification endpoint and we will see a message saying that our email has been verified. Now we are ready to start using Giza CLI! -Lets start by login into the platform: +Let's start by login into the platform: ```console ❯ giza users login @@ -307,7 +307,7 @@ We should be ready to start using Giza's capabilities, we can easily check by ru Now we are ready to transpile our model to Cairo! We want to help you jumpstart your journey into ZKML by helping you to create this amazing models, we abstract you from the tedious process of introspecting the model and getting the information needed to use it in Cairo, that's why we build the transpilation process, to ease this and improve the iteration time from creating a model to using it in Cairo! -Lets check how we can do it: +Let's check how we can do it: ```console ❯ giza transpile mnist_pytorch.onnx --output-path mnist_cairo From 988e6c249e18f2247b86339c6bbd8d4a2b10b1b4 Mon Sep 17 00:00:00 2001 From: iwantanode <87604944+tudorpintea999@users.noreply.github.com> Date: Wed, 13 Dec 2023 06:41:40 +0200 Subject: [PATCH 02/11] minor typos full_transpilation.md --- docs/examples/full_transpilation.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/examples/full_transpilation.md b/docs/examples/full_transpilation.md index 1eef394..6f87b06 100644 --- a/docs/examples/full_transpilation.md +++ b/docs/examples/full_transpilation.md @@ -87,7 +87,7 @@ test_loader = torch.utils.data.DataLoader( ])), shuffle=True) ``` -Now lets see an example of the data that we have just downloaded: +Now let's see an example of the data that we have just downloaded: ```python @@ -103,7 +103,7 @@ print(f"example_targets.shape: {example_targets.shape}") ## How To Train The Model -Now its time to train the model, for this we are going to define a basic neural network with 2 hidden layers and 1 output layer. +Now it's time to train the model, for this we are going to define a basic neural network with 2 hidden layers and 1 output layer. We will follow the usual way of training a model in Pytorch by creating a `torch.nn.Module` class and defining the `forward` method. The `forward` method is the method that will be called when we pass an input to the model. @@ -224,7 +224,7 @@ for i in range(10): Train Epoch: 9 [50000/60000 (83%)] Loss: 0.000008 -Lets perform a simple prediction to see how the model performs: +Let's perform a simple prediction to see how the model performs: ```python @@ -336,7 +336,7 @@ Also, if you ever have a question about the commands that you can run you can al Back to the transpilation! -So we have received a file that we have saved in the `mnist_cairo` directory, lets check the contents of the directory: +So we have received a file that we have saved in the `mnist_cairo` directory, let's check the contents of the directory: ```console ❯ tree mnist_cairo @@ -408,7 +408,7 @@ mod inference; +mod input; ``` -Now lets create the `input.cairo` file. For this we are going to take the example data that we used to train the model and we are going to convert it to Cairo tensors. In cairo the tensors that contains `floats` are represented as `FP16x16` numbers, so we need to convert the data to this format. +Now let's create the `input.cairo` file. For this we are going to take the example data that we used to train the model and we are going to convert it to Cairo tensors. In cairo the tensors that contains `floats` are represented as `FP16x16` numbers, so we need to convert the data to this format. ```python From e8a97c33db184fa8884cc145f86dcb9a3db68da7 Mon Sep 17 00:00:00 2001 From: iwantanode <87604944+tudorpintea999@users.noreply.github.com> Date: Wed, 13 Dec 2023 06:42:35 +0200 Subject: [PATCH 03/11] minor typos transpile.md --- docs/frameworks/cairo/transpile.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/frameworks/cairo/transpile.md b/docs/frameworks/cairo/transpile.md index 92f8a4b..cf128b1 100644 --- a/docs/frameworks/cairo/transpile.md +++ b/docs/frameworks/cairo/transpile.md @@ -85,7 +85,7 @@ There are three main methods for transpiling a model: - The output of the transpilation process is saved in the same location as the original model. ```console -# Using the previous model (id: 2) we can transpile a new model, which will create verion 2 of the model. +# Using the previous model (id: 2) we can transpile a new model, which will create version 2 of the model. giza transpile --model-id 29 awesome_model.onnx --output-path new_awesome_model [giza][2023-09-13 14:11:30.015] Model found with id -> 2! ✅ [giza][2023-09-13 14:11:30.541] Sending model for transpilation ✅ @@ -117,7 +117,7 @@ giza versions list --model-id 29 "size": 52735, "status": "COMPLETED", "message": "Transpilation Successful!", - "description": "Intial version", + "description": "Initial version", "created_date": "2023-09-13T12:08:38.177605", "last_update": "2023-09-13T12:08:43.986137" }, @@ -126,7 +126,7 @@ giza versions list --model-id 29 "size": 52735, "status": "COMPLETED", "message": "Transpilation Successful!", - "description": "Intial version", + "description": "Initial version", "created_date": "2023-09-13T12:11:30.165440", "last_update": "2023-09-13T12:11:31.625834" } From 1bae2c8ce68c21ee5eb696e41a1d061514f5bb06 Mon Sep 17 00:00:00 2001 From: iwantanode <87604944+tudorpintea999@users.noreply.github.com> Date: Wed, 13 Dec 2023 06:43:10 +0200 Subject: [PATCH 04/11] Update transpile.md --- docs/frameworks/ezkl/transpile.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/frameworks/ezkl/transpile.md b/docs/frameworks/ezkl/transpile.md index f013fce..5fa1f01 100644 --- a/docs/frameworks/ezkl/transpile.md +++ b/docs/frameworks/ezkl/transpile.md @@ -64,7 +64,7 @@ There are three main methods for transpiling a model: - The output of the transpilation process is saved in the same location as the original model. ```console -# Using the previous model (id: 2) we can transpile a new model, which will create verion 2 of the model. +# Using the previous model (id: 2) we can transpile a new model, which will create version 2 of the model. > giza transpile --framework EZKL --model-id 2 --input-data input.json awesome_model.onnx [giza][2023-12-04 19:40:10.646] Model found with id -> 2! ✅ [giza][2023-12-04 19:40:12.176] Sending model for Setup ✅ @@ -96,7 +96,7 @@ giza versions list --model-id 29 "size": 52735, "status": "COMPLETED", "message": "Setup Successful!", - "description": "Intial version", + "description": "Initial version", "created_date": "2023-09-13T12:08:38.177605", "last_update": "2023-09-13T12:08:43.986137" }, @@ -105,7 +105,7 @@ giza versions list --model-id 29 "size": 52735, "status": "Setup", "message": "Transpilation Successful!", - "description": "Intial version", + "description": "Initial version", "created_date": "2023-12-04T12:11:30.165440", "last_update": "2023-12-04T12:11:31.625834" } From 6256aa328c6f8cf00b6df0131d8ff67aaab63f11 Mon Sep 17 00:00:00 2001 From: iwantanode <87604944+tudorpintea999@users.noreply.github.com> Date: Wed, 13 Dec 2023 06:43:57 +0200 Subject: [PATCH 05/11] Update README.md --- docs/reference/api/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/api/README.md b/docs/reference/api/README.md index 625ef75..98710b0 100644 --- a/docs/reference/api/README.md +++ b/docs/reference/api/README.md @@ -37,7 +37,7 @@ - [`client.VersionJobsClient`](./client.md#class-versionjobsclient): Client to interact with `jobs` endpoint. - [`client.VersionsClient`](./client.md#class-versionsclient): Client to interact with `versions` endpoint. - [`exceptions.PasswordError`](./exceptions.md#class-passworderror) -- [`echo.Echo`](./utils.echo.md#class-echo): Helper class to use when printin output of the CLI. +- [`echo.Echo`](./utils.echo.md#class-echo): Helper class to use when printing output of the CLI. - [`enums.Framework`](./utils.enums.md#class-framework) - [`enums.JobKind`](./utils.enums.md#class-jobkind) - [`enums.JobSize`](./utils.enums.md#class-jobsize) From da613fb842245041904a71d11a94b21e10bdf7b8 Mon Sep 17 00:00:00 2001 From: iwantanode <87604944+tudorpintea999@users.noreply.github.com> Date: Wed, 13 Dec 2023 06:46:22 +0200 Subject: [PATCH 06/11] Update client.md --- docs/reference/api/client.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/reference/api/client.md b/docs/reference/api/client.md index db06d21..f20f27e 100644 --- a/docs/reference/api/client.md +++ b/docs/reference/api/client.md @@ -410,7 +410,7 @@ Make a call to the API to retrieve model information. **Args:** - - `model_id`: Model identfier to retrieve information + - `model_id`: Model identifier to retrieve information @@ -507,7 +507,7 @@ Update a model. **Args:** - - `model_id`: Model identfier to retrieve information + - `model_id`: Model identifier to retrieve information - `model_update`: body to partially update the model @@ -592,7 +592,7 @@ Make a call to the API to retrieve job information. **Args:** - - `job_id`: Job identfier to retrieve information + - `job_id`: Job identifier to retrieve information @@ -730,7 +730,7 @@ Make a call to the API to retrieve job information. **Args:** - - `job_id`: Job identfier to retrieve information + - `job_id`: Job identifier to retrieve information @@ -855,7 +855,7 @@ Make a call to the API to retrieve proof information. **Args:** - - `proof_id`: Proof identfier to retrieve information + - `proof_id`: Proof identifier to retrieve information From ef4b3b90740759b5aaf0ff8b0860f1405cd62727 Mon Sep 17 00:00:00 2001 From: iwantanode <87604944+tudorpintea999@users.noreply.github.com> Date: Wed, 13 Dec 2023 06:47:38 +0200 Subject: [PATCH 07/11] Update commands.transpile.md --- docs/reference/api/commands.transpile.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/api/commands.transpile.md b/docs/reference/api/commands.transpile.md index a6cc2c4..590a7b3 100644 --- a/docs/reference/api/commands.transpile.md +++ b/docs/reference/api/commands.transpile.md @@ -43,7 +43,7 @@ This command will do a couple of things behind the scenes: * Create a Model ent **Raises:** - - `BadZipFile`: if the recieved file is not a zip, could be due to a transpilation error at the API. + - `BadZipFile`: if the received file is not a zip, could be due to a transpilation error at the API. - `HTTPError`: request error to the API, 4XX or 5XX From 4f6150f13dce78d42137720bd88eae50fbb1857d Mon Sep 17 00:00:00 2001 From: iwantanode <87604944+tudorpintea999@users.noreply.github.com> Date: Wed, 13 Dec 2023 06:48:40 +0200 Subject: [PATCH 08/11] Update frameworks.cairo.md --- docs/reference/api/frameworks.cairo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/api/frameworks.cairo.md b/docs/reference/api/frameworks.cairo.md index 6dcdd04..076afe2 100644 --- a/docs/reference/api/frameworks.cairo.md +++ b/docs/reference/api/frameworks.cairo.md @@ -27,7 +27,7 @@ prove( ) → None ``` -Command to prove as spceific cairo program, previously converted to CASM. This will create a proving job and check the status, once it finishes if COMPLETED the proof is downloaded at the output path The daily jobs allowed are rate limited by the backend. +Command to prove as specific cairo program, previously converted to CASM. This will create a proving job and check the status, once it finishes if COMPLETED the proof is downloaded at the output path The daily jobs allowed are rate limited by the backend. From b1099b4eff33ac0009a80eb8ed63c91d8b1de177 Mon Sep 17 00:00:00 2001 From: iwantanode <87604944+tudorpintea999@users.noreply.github.com> Date: Wed, 13 Dec 2023 06:49:27 +0200 Subject: [PATCH 09/11] Update utils.echo.md --- docs/reference/api/utils.echo.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/api/utils.echo.md b/docs/reference/api/utils.echo.md index fb131f2..c647153 100644 --- a/docs/reference/api/utils.echo.md +++ b/docs/reference/api/utils.echo.md @@ -14,7 +14,7 @@ ## class `Echo` -Helper class to use when printin output of the CLI. +Helper class to use when printing output of the CLI. Provides utilities to print different levels of the messages and provides formatting capabilities to each of the levels. @@ -80,7 +80,7 @@ Main function to print information of a message, original message is provided as error(message: str) → None ``` -Format and echo a error message +Format and echo an error message From e776d7dc14388f09b218f53f90c02bdefffd7c4b Mon Sep 17 00:00:00 2001 From: iwantanode <87604944+tudorpintea999@users.noreply.github.com> Date: Wed, 13 Dec 2023 06:50:01 +0200 Subject: [PATCH 10/11] Update models.md --- docs/resources/models.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/resources/models.md b/docs/resources/models.md index ac5f618..77403cf 100644 --- a/docs/resources/models.md +++ b/docs/resources/models.md @@ -103,7 +103,7 @@ Transpiling a model in Giza can be done in three ways, each designed to provide 3. **Using a previous model:** If you have a previously created model, you can transpile it by indicating the model-id in the `giza transpile --model-id ...` or `giza versions transpile --model-id` command. This method is useful when you want to create a new version of an existing model. -*Note: remember to use the `--framework` flag to indicate which one to use. It defaultss to Cairo* +*Note: remember to use the `--framework` flag to indicate which one to use. It defaults to Cairo* Remember, the choice of method depends on your specific needs and workflow. Giza provides these options to ensure that you can work with your models in the most efficient way possible. From f3f3a91434141137c6d7f0c8523d307f480564d6 Mon Sep 17 00:00:00 2001 From: iwantanode <87604944+tudorpintea999@users.noreply.github.com> Date: Wed, 13 Dec 2023 06:50:23 +0200 Subject: [PATCH 11/11] Update users.md --- docs/resources/users.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/resources/users.md b/docs/resources/users.md index 788cb28..fc57df6 100644 --- a/docs/resources/users.md +++ b/docs/resources/users.md @@ -27,11 +27,11 @@ This will create an *inactive* user in Giza, to activate it you need to verify y If there is an error or you want to have more information about what it's going on there is a `--debug` flag that will add more information about the error. This will print outgoing requests to the API, debug logs and python traceback about what happened. -⚠️**Note**: be aware that the debug option will print everything that its going to the API, in this case the password will be printed as plain text in the terminal, if you are using the debug option to fill a issue make sure to remove the credentials. +⚠️**Note**: be aware that the debug option will print everything that its going to the API, in this case the password will be printed as plain text in the terminal, if you are using the debug option to fill an issue make sure to remove the credentials. ### Login -Log into Giza platfrom and retieve a JWT for authentication. This JWT will be stored to authenticate you later until the token expires. +Log into Giza platfrom and retrieve a JWT for authentication. This JWT will be stored to authenticate you later until the token expires. **You need te have an active account to log in**