Quickstart

Run it

Edge Python ships as a ~200 KB WASM module. The fastest way to try it is the playground. No install. Everything runs client-side.

Embed it

To put Edge Python in your own page, drop in the <edge-python> element below. Building the .wasm from source or embedding in Rust/WASI: see Where it runs.

Drop-in HTML element

In the browser, the <edge-python> element runs a .py file declaratively. No JS wiring. With a host library like dom (declared in packages.json), the script renders straight into the page:


<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <script type="module" src="https://cdn.edgepython.com/runtime/src/element.js"></script>
</head>
<body>
  <div id="app"></div>
  <edge-python entry="./app/hello.py" packages="./app/packages.json"></edge-python>
</body>
</html>


// packages.json
{ "host": { "dom": "./dom/src/index.js" } }


# hello.py
from dom import query, set_text
set_text(query("#app"), "Hello from Python")

dom is one of the official host libraries (dom, network, storage…). Standard .wasm packages like json sit alongside them. The packages.json above declares dom explicitly. The browser runtime also resolves the official packages by bare name, with no manifest (see Defaults). Each is fetched lazily on first import.

See Official packages for the full catalog. See the runtime README for all <edge-python> attributes and the imports field for .py / .wasm modules.

Your first program

Try to run or modify this script:

greet = lambda name: f"Hello, {name}!" for who in ["world", "edge", "python"]: print(greet(who))

Output · expected


Hello, world!
Hello, edge!
Hello, python!