Quickstart

Install the CLI

curl -fsSL https://cdn.edgepython.com/cli/install.sh | sh

bash

The installer works on macOS, Linux, and WSL. Open a new shell and check the install:

edge --version

bash

To build from source instead, run cargo install --path cli from the repo root. See the CLI reference for install details and flags.

Run your first script

Create hello.py:

def greet(name):
  return f"Hello, {name}!"

for who in ["world", "edge", "python"]:
  print(greet(who))

cmd + enter

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

Output

Run it from your terminal:

edge run hello.py

bash

There is no build step. The CLI compiles the file and runs it.

Import your first package

Edge Python ships no standard library, and nothing resolves until you declare it. Declare json first:

edge add json

bash

That writes edge.json beside your script:

{
  "imports": {
    "json": "https://cdn.edgepython.com/std/json.wasm"
  }
}

json

Now create app.py:

import json

data = json.loads('{"name": "edge", "tags": ["fast", "small"]}')
data["tags"].append("sandboxed")
print(json.dumps(data))

cmd + enter

{"name":"edge","tags":["fast","small","sandboxed"]}

Output

Run it:

edge run app.py

bash

The CLI keeps the official packages inside the binary, so the entry needs no network there. The package catalog lives in Modules and the manifest format in edge.json.

Next steps

Syntax walks through the language.
Command line interface covers serve, repl, test, build, and actor.
Actors runs many programs as cooperative tasks.