Skip to content

docs: update Run Interactive Apps #75

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
isabelizimm merged 5 commits into from
Jun 11, 2025
Merged

docs: update Run Interactive Apps #75

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
03fc97d
some small edits to run app page
isabelizimm May 29, 2025
65cadf6
rearrange for clarity
isabelizimm May 29, 2025
0480926
Merge branch 'main' into docs-run-app
isabelizimm May 30, 2025
51b2331
Apply suggestions from code review
isabelizimm Jun 11, 2025
cb3759f
add terminal.integrated.shellIntegration.enabled
isabelizimm Jun 11, 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
16 changes: 10 additions & 6 deletions run-interactive-apps.qmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,13 @@ Positron provides a simplified method for running interactive apps via the **Pla

Currently, Positron supports the following Python app frameworks:

- Dash
- FastAPI
- Flask
- Gradio
- Shiny
- Streamlit
- [Dash](https://dash.plotly.com/)
- [FastAPI](https://fastapi.tiangolo.com/)
- [Flask](https://flask.palletsprojects.com/en/stable/)
- [Gradio](https://www.gradio.app/)
- [Shiny](https://shiny.posit.co/py/)
- [Streamlit](https://streamlit.io/)


## Running an interactive app

Expand All @@ -25,9 +26,12 @@ Currently, Positron supports the following Python app frameworks:
![Positron App Launcher Play button](images/run-app-play-button.png)

Then, Positron runs the app in a dedicated **Terminal** tab and opens the app URL in the **Viewer** pane.
If your application does not automatically open in the Viewer, check that the settings [`python.terminal.shellIntegration.enabled`](positron://settings/python.terminal.shellIntegration.enabled) and [`terminal.integrated.shellIntegration.enabled`](positron://settings/terminal.integrated.shellIntegration.enabled) are enabled.

![A Streamlit app in the Positron Viewer](images/run-app-streamlit.png)

To stop the app, select the **Terminal** tab running the application and use the trash can icon to delete the **Terminal** or press <kbd>Ctrl</kbd> + <kbd>C</kbd> to stop the process.

## Debugging an interactive app

1. Open the `.py` file of a supported app framework.
Expand Down