Skip to Content
Getting StartedQuickstart

Install the CLI

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

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

edge --version

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))
Output · expected
Hello, world! Hello, edge! Hello, python!

Run it from your terminal:

edge run hello.py

There is no build step. The CLI compiles the file and runs it in its native engine.

Import your first package

Edge Python ships no standard library. The official packages resolve by bare name, with no configuration. Create app.py:

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

Run it:

edge run app.py

To record the dependency in your project, run edge add json. It writes the package to packages.json. The package catalog lives in Modules and the manifest format in packages.json.

Next steps

Last updated on