Skip to content

Add some info about running python scripts via cli #847

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.

Sign up for GitHub

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

Merged
merged 3 commits into from
Sep 25, 2025
Merged

Add some info about running python scripts via cli #847

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ef03b3c
add some info about cli and python script
brisvag Sep 23, 2025
b90f293
Merge branch 'main' into feature/python-scripts
brisvag Sep 24, 2025
ad9dc3d
Merge branch 'main' into feature/python-scripts
brisvag Sep 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion docs/tutorials/fundamentals/features.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,13 @@ To see it in action, see the {ref}`sphx_glr_gallery_features_table_widget.py` ga

## Running python scripts with napari

Images and other data files are not the only thing that napari can read! You can also run any python script in napari by [drag'n'dropping](https://github.com/napari/napari/blob/main/examples/drag_and_drop_python_code.py) the script onto the viewer. When a script is opened with napari the first viewer instance created by the script will be replaced with the current existing viewer.
Images and other data files are not the only thing that napari can read! You can also run any python script in napari by [drag'n'dropping](https://github.com/napari/napari/blob/main/examples/drag_and_drop_python_code.py) the script onto the viewer, or by passing the script as an argument to napari. When a script is opened with napari, the first viewer instance created by the script will be replaced with the current existing viewer, if any.

It even works with remote files!

```bash
napari https://github.com/napari/napari/blob/main/examples/add_3D_image.py
```

This feature is especially useful for quickly testing or distributing code snippets without needing to leave the viewer or touch the console.

Expand Down