Skip to content

Adding placeholder notebooks for detailed tutorials #141

Merged
samet-akcay merged 36 commits into
openvinotoolkit:docs/tutorialsfrom
amul1umt:main
May 29, 2026
Merged

Adding placeholder notebooks for detailed tutorials #141
samet-akcay merged 36 commits into
openvinotoolkit:docs/tutorialsfrom
amul1umt:main

Conversation

@amul1umt
Copy link
Copy Markdown

Summary

Placeholder notebooks for detailed tutorials upcoming for developers to try it out

Why

Easy starting guides for developers using SO101 robot

Validation

Breaking changes

  • None

Related issues

  • Closes #

@amul1umt amul1umt requested review from a team as code owners May 28, 2026 16:24
@amul1umt
Copy link
Copy Markdown
Author

moved all the notebooks to tutorials directory and updated README.

Radwan-Ibrahim
Radwan-Ibrahim previously approved these changes May 29, 2026
@amul1umt amul1umt requested a review from Radwan-Ibrahim May 29, 2026 21:12
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

would it be possible to use the banner here to avoid duplication?
https://github.com/openvinotoolkit/physicalai/blob/main/docs/assets/physicalai.png

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Radwan asked to change this one, with the OpenVINO Physical AI

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

would it be possible to have the raw files like svg, so we could modify them later if needed?
.png files cannot be modified

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

would it be possible to have consistent filename extensions?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

and same comment as above regarding raw files

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

also would it be possible to follow a consistent design theme. For example standardized arrows, colors, box shapes with fixed radius (rectangle vs ellipse) etc

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

also, big arrows are a bit large and not well aligned.
similar to above, raw files would be great to modify them

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

the boxes in this figure are not consistent with the rest of the figures. would be great to follow the same style in terms of consistency

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

would it be possible to use snake_case naming convention please?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

would it be possible to use snake_case naming convention?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

would it be possible to use snake_case naming convention please?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

examples/tutorials/media/download-model.png file uses red bounding box around the button. To follow the same convention, it would be great if this also has a bounding box. or vice-versa?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

similar to the above naming conventions, it would be great to follow snake_case naming convention for this, and the rest of the jupyter notebooks.

so something like 001_introduction.ipynb

**Getting Started**
```bash
pip install "physicalai[so101,capture]" physicalai-train
pip install jupyter # if jupyter notebook is not already installed
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

can you add jupyter here like

notebooks = ["matplotlib", "matplotlib-inline", "ipykernel",  "jupyter"]

notebooks = ["matplotlib", "matplotlib-inline", "ipykernel"]

so this way, users can run pip install physicalai[capture,so101,jupyter]

it's cleaner

```bash
pip install "physicalai[so101,capture]" physicalai-train
pip install jupyter # if jupyter notebook is not already installed
phython -m venv venv
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

there is a typo here. also, if we really want users to install from source, not pypi, uv could also be an option.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

this requirements.txt file is not needed, and actually we should not have these to avoid inconsistent behaviour. they should follow the official installation guidelines from pyproject.toml file

Copy link
Copy Markdown
Contributor

@samet-akcay samet-akcay left a comment

Choose a reason for hiding this comment

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

we could temporarily merge these to main. However, we will need to work on this content to further polish

@samet-akcay samet-akcay self-requested a review May 29, 2026 21:30
Comment on lines +53 to +54
snapshot_download(
repo_id=repo_id,
Comment on lines +92 to +93
snapshot_download(
repo_id=repo_id,
Comment on lines +114 to +115
hf_hub_download(
repo_id=repo_id,
Copy link
Copy Markdown
Contributor

@samet-akcay samet-akcay left a comment

Choose a reason for hiding this comment

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

@amul1umt CI checks are failing. Would you like to address them, or would you want me to address them?

I could address them by merging this pr into docs/tutorial branch and work on it ? Which one would you prefer ?

@samet-akcay samet-akcay changed the base branch from main to docs/tutorials May 29, 2026 22:08
@samet-akcay samet-akcay merged commit 6f764b8 into openvinotoolkit:docs/tutorials May 29, 2026
12 of 16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants