Lizard Python SDK
Run commands, work with files and execute code in Linux sandboxes on Kubernetes. The SDK also manages Lizard apps, databases, storage and projects.
Install
Requires Python 3.10+. The Python client is synchronous.
pip install lizard-sdk
Create an API key and project at lizard.build, then set:
export LIZARD_API_KEY="your-api-key"
Create a sandbox
Save this as quickstart.py. Replace my-project with your project's ID, slug or unique name, then run python quickstart.py.
from lizard import Lizard
lizard = Lizard(project="my-project")
with lizard.create("base", timeout_ms=300_000) as sandbox:
sandbox.fs.write("/tmp/hello.txt", "Hello from Lizard!")
result = sandbox.process.exec_("cat /tmp/hello.txt")
if result.exit_code != 0:
raise RuntimeError(result.stderr)
print(result.stdout)
The context manager kills the sandbox when the block ends, including when it raises an error. If you create a sandbox without with, call sandbox.kill() in a finally block.
Stream command output
Inside the with block above:
result = sandbox.process.exec_(
'printf "hello\\n"',
timeout_ms=30_000,
on_stdout=lambda chunk: print(chunk, end=""),
on_stderr=lambda chunk: print(chunk, end=""),
)
if result.exit_code != 0:
raise RuntimeError(result.stderr)
Run code
CodeSandbox uses the code-interpreter-v1 template by default. Code errors appear in result.error; request failures raise an exception.
from lizard import CodeSandbox
with CodeSandbox.create(project="my-project") as sandbox:
result = sandbox.run_code(
"print(6 * 7)",
language="python",
timeout_ms=60_000,
on_stdout=lambda chunk: print(chunk, end=""),
)
if result.error:
raise RuntimeError(result.error.message)
Configuration
The SDK reads LIZARD_API_KEY and, optionally, LIZARD_API_URL (default: https://lizard.build). You can also pass api_key and api_url to the constructor or static sandbox methods.
Pass timeout_ms to create() to set the sandbox lifetime. The default is five minutes. timeout_ms on process.exec_() or run_code() controls that call, not the sandbox lifetime.
Runtime limits
Sandboxes run on Kubernetes. Use volumes mounted at /workspace to keep files after a sandbox ends. Pause, resume, fork, snapshot creation and snapshot restore return HTTP 501 on the current backend.
get_host() returns a hostname without https://. File writes accept UTF-8 text or valid UTF-8 bytes; read_bytes() supports binary downloads.
Learn more
1 maintainer
Metadata
1 maintainer
Release files for lizard-sdk 0.1.42
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| lizard_sdk-0.1.42.tar.gz | 35.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| lizard_sdk-0.1.42-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 78.9 kB
Release files / lizard_sdk-0.1.42.tar.gz
| Download URL | lizard_sdk-0.1.42.tar.gz |
|---|---|
| Size | 35.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cd2eb55c96ad45757d80aa5fc41a65f7f53003f0266f1b45b70bfe9f836c8889
|
|
BLAKE2b-256 checksum How to use checksums |
2c78d2e8d4fe7592fac681efa93947ba547657617280ab6a9666ad87a4647f26
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.
Transparency logRelease files / lizard_sdk-0.1.42-py3-none-any.whl
| Download URL | lizard_sdk-0.1.42-py3-none-any.whl |
|---|---|
| Size | 43.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d8fd3cab89837ce13b8f8c76b74fe65d2907352bd9cb145df812fd1d576675e1
|
|
BLAKE2b-256 checksum How to use checksums |
81828f14192032c43985d2b92f98f7beee7e90ad04b02b120ac48cab40e62c0d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.
Transparency log
