> ## Documentation Index
> Fetch the complete documentation index at: https://docs.declaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-Language Execution

> Run shell commands, Python scripts, and complex pipelines within a single Declaw sandbox.

## What You'll Learn

* Running shell commands for system info
* Running Python one-liners and multi-line scripts
* Writing scripts to the sandbox filesystem and executing them
* Using shell pipelines (`sort`, `uniq`, etc.)
* All within a single sandbox session
* Proper cleanup with `try/finally` and `sbx.kill()`

## Prerequisites

<Snippet file="snippets/env-setup.mdx" />

<Note>This example is available in Python. TypeScript version coming soon.</Note>

## Code Walkthrough

**Shell commands** — run any system utility directly:

```python theme={null}
from declaw import Sandbox

sbx = Sandbox.create(template="python", timeout=300)
try:
    result = sbx.commands.run("uname -a")
    print(f"  {result.stdout.strip()}")
```

**Python one-liner** — invoke `python3 -c` for quick computations:

```python theme={null}
    result = sbx.commands.run(
        'python3 -c "import sys; print(\'Python \' + sys.version.split()[0]); print(\'2+2 =\', 2+2)"'
    )
    print(f"  {result.stdout.strip()}")
```

**Write and execute a Python script** — use `sbx.files.write()` to upload code, then run it:

```python theme={null}
    script = """
def fibonacci(n):
    a, b = 0, 1
    result = []
    for _ in range(n):
        result.append(a)
        a, b = b, a + b
    return result

fib = fibonacci(10)
print("First 10 Fibonacci numbers:", fib)
print("Sum:", sum(fib))
"""
    sbx.files.write("/tmp/fib.py", script)
    result = sbx.commands.run("python3 /tmp/fib.py")
    print(f"  {result.stdout.strip()}")
```

**Shell pipeline** — chain Unix utilities:

```python theme={null}
    result = sbx.commands.run(
        "printf 'banana\\napple\\ncherry\\ndate\\napple' | sort | uniq -c | sort -rn"
    )
    print(f"  Output:\n{result.stdout}")
```

**Shell script** — write a `.sh` file and run it with `sh`:

```python theme={null}
    shell_script = """#!/bin/sh
echo "=== System Report ==="
echo "Kernel: $(uname -r)"
echo "Architecture: $(uname -m)"
echo "CPU cores: $(nproc)"
echo "Memory: $(cat /proc/meminfo | head -1)"
echo "Python: $(python3 --version)"
"""
    sbx.files.write("/tmp/report.sh", shell_script)
    result = sbx.commands.run("sh /tmp/report.sh")
    print(f"  {result.stdout.strip()}")
finally:
    sbx.kill()
```

## Expected Output

```
==================================================
Declaw Multi-Language Execution Example
==================================================

--- 1. Shell: System Info ---
  Linux declaw-sandbox 6.1.158 ...

--- 2. Python: Version & Calculation ---
  Python 3.10.12
  2+2 = 4

--- 3. Python Script: Fibonacci ---
  First 10 Fibonacci numbers: [0, 1, 1, 2, 3, 5, 8, 13, 21, 34]
  Sum: 88

--- 4. Shell: Pipeline ---
  2 apple
  1 date
  ...

--- 5. Shell Script: System Report ---
  Kernel: 6.1.158
  Architecture: x86_64
  ...
```