Viewing: edgepython.com

Getting Started
Introduction
Quickstart

Copy page

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 expectedRun


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 expectedRun


{"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

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

Last updated on August 22, 2026

Introduction