Skip to main content

Open-source fork-on-write microVM sandbox primitive (E2B-compatible surface)

Project description

forkd — Python SDK

E2B-compatible sandbox API backed by forkd.

from forkd import Sandbox

with Sandbox() as sandbox:
    result = sandbox.commands.run("python3 -c 'import numpy; print(numpy.zeros(3))'")
    print(result.stdout)        # [0. 0. 0.]
    print(result.exit_code)     # 0

Or with explicit lifecycle:

sandbox = Sandbox()
result = sandbox.commands.run("echo hello")
sandbox.kill()

Bonus: warmed-state eval

If your snapshot parent imported numpy, you can skip subprocess overhead and use the warmed PID-1 interpreter directly:

with Sandbox() as sandbox:
    out = sandbox.eval("numpy.zeros(5).tolist()")   # ~8 ms
    # vs commands.run("python3 -c '...'") which is ~108 ms (fresh subprocess)

Requirements

The forkd Rust CLI must be installed and on PATH, plus a parent snapshot must already exist (forkd snapshot --tag pyagent ...). See the main README for the full setup.

Status

Pre-alpha. Currently supports:

  • Sandbox() / Sandbox.create() — spawn one sandbox
  • sandbox.commands.run(cmd) — run command, get stdout/stderr/exit_code
  • sandbox.eval(expr) — eval Python in warmed PID 1
  • sandbox.kill() — terminate

Not yet (blocked on issues #1 + #4):

  • Multiple concurrent Sandbox() instances (all share parent's MAC/IP)
  • sandbox.files.read/write — filesystem operations
  • Streaming output

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

forkd-0.1.3.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

forkd-0.1.3-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

Details for the file forkd-0.1.3.tar.gz.

File metadata

  • Download URL: forkd-0.1.3.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for forkd-0.1.3.tar.gz
Algorithm Hash digest
SHA256 ba1bd42ef8413fae9e3ae6d7739df98099c9058659e4e666cd08d87fd1d992b2
MD5 1599b0b30ee5f0856300d205480946fd
BLAKE2b-256 9bb14f25a3f5832b40aebab3ac26ccd0aacefb637c60dd190c37d53468cc3a5a

See more details on using hashes here.

Provenance

The following attestation bundles were made for forkd-0.1.3.tar.gz:

Publisher: publish-pypi.yml on deeplethe/forkd

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file forkd-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: forkd-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 5.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for forkd-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 af14e171d3bd800ae7501d4f77eec9547b5066bbd53aed94d30cb9576217afaf
MD5 dbea846cfb6bf2277937b7505a82458f
BLAKE2b-256 b9960e058f5c2a470e661dfdb0cb445c27e7359d674a8c9dc6d3e77519d1c277

See more details on using hashes here.

Provenance

The following attestation bundles were made for forkd-0.1.3-py3-none-any.whl:

Publisher: publish-pypi.yml on deeplethe/forkd

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page