Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: Add Python Client Examples #395

Merged
merged 16 commits into from
Jul 24, 2023
Merged

Conversation

lgdeloss
Copy link
Contributor

@lgdeloss lgdeloss commented Jun 9, 2023

Motivation

  • There is lack of documentation for how to interface with modelmesh-serving using python sdk

Modifications

  • Added documentation on how to interface with Python client sdk for modelmesh-serving
  • Added docs/samples/modelmesh_sdk_sample.ipynb

Result

@lgdeloss lgdeloss changed the title doc: Add Python Client Examples #375 doc: Add Python Client Examples Jun 9, 2023
@rafvasq rafvasq self-assigned this Jun 9, 2023
@rafvasq rafvasq self-requested a review June 9, 2023 19:04
Copy link
Member

@rafvasq rafvasq left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Few more updates. I think there'd be some confusion on the headers and flow of the sample if you read it like a new user. You can probably be a bit more descriptive like "Check InferenceService status after deploying" or " etc.

docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
rafvasq
rafvasq previously approved these changes Jul 11, 2023
Copy link
Member

@rafvasq rafvasq left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @lgdeloss, I think this is a good starting point for samples showing how to manipulate InferenceServices using the Python SDK.

@rafvasq rafvasq added this to the v0.11.0 milestone Jul 14, 2023
Copy link
Member

@ckadner ckadner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you Luis (and Rafael). It's great to finally get a few Python SDK examples.

Should we rename the file to "python_sdk_examples.ipynb" since this entire repo is dedicated to "modelmesh".

I'm not sure if "samples" is the best name for the folder. Samples imply a user can take something and use it with/witout modifications, like a model, a YAML file, a script. This notebook is more like a "how to" guide or tutorial. If we plan more SDK examples in the future maybe the folder should be "sdk" or "python-sdk" or "notebooks" or "examples", if we think we will have more in the future.

I have a few more comments/suggestions.

docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/samples/modelmesh_sdk_sample.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
rafvasq
rafvasq previously approved these changes Jul 20, 2023
@rafvasq rafvasq requested a review from ckadner July 20, 2023 16:46
Copy link
Member

@ckadner ckadner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is looking good! Just a few more nit-picks. In some places we could add a bit more text explanations to use this notebook to inform the user about what/why is happening / how ModelMesh/KServe works in the background.

docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Outdated Show resolved Hide resolved
docs/examples/python_sdk_examples.ipynb Show resolved Hide resolved
Copy link
Member

@ckadner ckadner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @lgdeloss

/lgtm

Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
Signed-off-by: Luis Delossantos <luisgd@ibm.com>
@kserve-oss-bot
Copy link
Collaborator

New changes are detected. LGTM label has been removed.

@kserve-oss-bot
Copy link
Collaborator

[APPROVALNOTIFIER] This PR is APPROVED

Approval requirements bypassed by manually added approval.

This pull-request has been approved by: ckadner, lgdeloss

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kserve-oss-bot kserve-oss-bot merged commit 5d71c59 into kserve:main Jul 24, 2023
2 checks passed
ckadner pushed a commit that referenced this pull request Jul 24, 2023
#### Motivation

- There is lack of documentation for how to interface with modelmesh-serving using python sdk

#### Modifications

- Added documentation on how to interface with Python client sdk for modelmesh-serving
- Added  `docs/samples/modelmesh_sdk_sample.ipynb`

#### Result

- Works on #316

Signed-off-by: Luis Delossantos <luisgd@ibm.com>
(cherry picked from commit 5d71c59)
ckadner pushed a commit that referenced this pull request Jul 24, 2023
#### Motivation

- There is lack of documentation for how to interface with modelmesh-serving using python sdk

#### Modifications

- Added documentation on how to interface with Python client sdk for modelmesh-serving
- Added  `docs/samples/modelmesh_sdk_sample.ipynb`

#### Result

- Works on #316

Signed-off-by: Luis Delossantos <luisgd@ibm.com>
(cherry picked from commit 5d71c59)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants