Pyodide¤

Insiders 1.0.0

This special pyodide fence uses Pyodide, Ace and Highlight.js to render an interactive Python editor. Everything runs on the client side. The first time Pyodide is loaded by the browser can be a bit long, but then it will be cached and the next time you load the page it will be much faster.

Click the "Run" button in the top-right corner, or hit Ctrl+Enter to run the code. You can install packages with Micropip:

import micropip

print("Installing cowsay...")
await micropip.install("cowsay")
print("done!")

```pyodide
import micropip

print("Installing cowsay...")
await micropip.install("cowsay")
print("done!")
```

Then you can import and use the packages you installed:

import cowsay
cowsay.cow("Hello World")

```pyodide
import cowsay
cowsay.cow("Hello World")
```

Packages installed with Micropip are cached by the browser as well, making future installations much faster.

Sessions¤

Editors with the same session share the same globals() dictionary, so you can reuse variables, classes, imports, etc., from another editor within the same session. This is why you can import cowsay in this editor, given you actually installed it in the first. Sessions are ephemeral: everything is reset when reloading the page. This means you cannot persist sessions across multiple pages. Try refreshing your page and running the code of the second editor: you should get a ModuleNotFoundError.

To use other sessions, simply pass the session="name" option to the code block:

something = "hello"

```pyodide session="something"
something = "hello"
```

Now lets print it in another editor with the same session:

print(something)

```pyodide session="something"
print(something)
```

And in another editor with the default session:

print(something)

```pyodide
print(something)
```

Pre-installing packages¤

In your own documentation pages, you might not want to add import micropip; await micropip.install("your-package") to every editor to show how to use your package. In this case, you can use the install option to pre-install packages. The option takes a list of comma-separated package distribution names:

import griffe
import dependenpy
print("OK!")

```pyodide install="griffe,dependenpy"
import griffe
import dependenpy
print("OK!")
```