Quickstart – Edge Python

Run it

Edge Python ships as a sub-200 KB WASM module. Fastest way to try it: the playground, where no install is needed and everything runs client-side.

Open the playground ->

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 is covered in Where it runs.

Drop-in HTML element

In the browser, the runtime’s <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, but the browser runtime also resolves the official packages by bare name with no manifest (see Defaults), fetching each lazily on first import. See Official packages for the full catalog, and the runtime README for all <edge-python> attributes and the imports field for .py / .wasm modules.

Your first program

Open the playground and try the Rosenblatt perceptron example, or paste your own Python snippet:

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

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

Introduction What It Is