agentic-sandbox 0.1.0

Sandboxed code execution: Process, Docker, Firecracker, Gateway
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# agentic-sandbox

Sandboxed code execution for the Agentic Framework.

## Features

- **Multiple Backends**: Process, Docker, Firecracker, Gateway
- **Language Support**: Python, Node.js, Rust, Go, Bash
- **Isolation**: Secure code execution in isolated environments
- **Async-first**: Built on Tokio

## Installation

```toml
[dependencies]
agentic-sandbox = "0.1"

# With Docker support
agentic-sandbox = { version = "0.1", features = ["docker"] }

# With Gateway (Firecracker)
agentic-sandbox = { version = "0.1", features = ["gateway"] }
```

## Quick Start

```rust
use agentic_sandbox::{ProcessSandbox, Sandbox};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let sandbox = ProcessSandbox::new();

    let result = sandbox.execute("print('Hello from Python!')").await?;

    println!("Output: {}", result.stdout);
    println!("Exit code: {}", result.exit_code);

    Ok(())
}
```

## Backends

| Backend | Feature | Use Case |
|---------|---------|----------|
| `ProcessSandbox` | `process` | Development (default) |
| `DockerSandbox` | `docker` | Production (containers) |
| `GatewaySandbox` | `gateway` | Production (Firecracker microVMs) |
| `FirecrackerSandbox` | `firecracker` | Direct Firecracker access |

## Security

- `ProcessSandbox`: **Development only** - no isolation
- `DockerSandbox`: Container isolation
- `GatewaySandbox`: microVM isolation (recommended for production)

## License

MIT