Skip to main content

Documentation Index

Fetch the complete documentation index at: https://edgepython.com/llms.txt

Use this file to discover all available pages before exploring further.

Install

Three ways to get Edge Python running.

Browser playground

The fastest path. No install, runs entirely client-side via WebAssembly. Open the playground ->

Native binary

Pre-built for Linux, macOS, and Windows on the releases page. Download, make executable, run.
chmod +x edge-linux-x86_64
./edge-linux-x86_64 -c 'print("hello")'
Output
hello

Build from source

Requires a recent stable Rust toolchain.
git clone https://github.com/dylan-sutton-chavez/edge-python
cd edge-python/compiler
cargo build --release
./target/release/edge -c 'print("hello")'

CLI usage

edge [options] <file>
edge -c <code>
OptionEffect
-c <code>Run inline code instead of reading a file
--sandboxEnforce hard limits on heap, ops, and call depth
-d / -ddDebug output — IC stats and heap footprint
-qSuppress info logs
-hShow help

Your first program

Save this as hello.py:
greet = lambda name: f"Hello, {name}!"

for who in ["world", "edge", "python"]:
    print(greet(who))
Run it:
edge hello.py
Output
Hello, world!
Hello, edge!
Hello, python!

A taste of the language

Edge Python is a functional subset of Python 3.13. Functions are first-class values. Lambdas, currying, higher-order functions, and comprehensions are central.
# First-class functions
ops = [abs, len, str]
print([f(-3) for f in ops])

# Currying
add = lambda x: lambda y: x + y
print(add(3)(4))

# Pure functions get memoized automatically
def fib(n):
    if n < 2: return n
    return fib(n - 1) + fib(n - 2)

print(fib(20))
Output
[3, 2, '-3']
7
6765

What’s next

What it is

Scope, paradigm, and what intentionally isn’t supported.

Syntax

Operators, literals, and the language surface.

Built-ins

Every built-in function with examples and outputs.

Methods

String, list, and dict methods.