hyperlight-dev / hyperlight-dev/hyperlight-sandbox
Add a cli interface
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 73
- Forks
- 7
- Avg merge
- 2d 2h
- Merged PRs (30d)
- 23
Description
This would make it easier to use in agent skills and and other tools.
Add a hyperlight-sandbox CLI binary so users can run scripts in an isolated sandbox directly from the terminal without writing a host program.
hyperlight-sandbox run script.py --backend wasm-python --allow-domain https://httpbin.org
Proposed CLI surface
hyperlight-sandbox run <SCRIPT> [OPTIONS]
Options:
--backend <wasm-python|wasm-js|hyperlightjs|nanvix-js|nanvix-python>
Sandbox backend [default: wasm-python]
--module <PATH> AOT-compiled guest module (uses backend default if omitted)
--input <DIR> Read-only host dir mounted at /input
--output <DIR> Writable host dir mounted at /output
--allow-domain <URL> Allow network access (repeatable)
--config <FILE> TOML config file (flags override)
--heap-size <BYTES> Guest heap size
--stack-size <BYTES> Guest stack size
-v, --verbose Debug logging
Config file (TOML)
Possible config file.
backend = "wasm-python"
module = "python-sandbox.aot"
[network]
allow_domains = ["https://httpbin.org"]
[fs]
input = "./data"
output = "./results"
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by locating the hyperlight-sandbox binary entry point and the existing backend interfaces. Map how the run command would select a backend, load the TOML configuration, and apply filesystem, network, heap, and stack options; done means the proposed command and documented flags work for the listed backends.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- cli
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100