What is a Podflare sandbox?

from podflare import Sandbox

with Sandbox() as sb:
    # This is not a container. This is a Linux box.
    print(sb.run_code("uname -a", language="bash").stdout)
    # Linux ... 6.1.x ... x86_64 ... GNU/Linux

with Sandbox() as sb:
    sb.run_code("pip install scikit-learn pandas requests", language="bash")
    # Now use them:
    out = sb.run_code("""
        import pandas as pd
        from sklearn.linear_model import LinearRegression
        print("pandas:", pd.__version__, "sklearn:", LinearRegression().__class__.__name__)
    """)
    print(out.stdout)
    # pandas: 2.x  sklearn: LinearRegression

with Sandbox() as sb:
    sb.run_code("pip install openai", language="bash")
    out = sb.run_code("""
        import os, openai
        client = openai.OpenAI(api_key='sk-...')
        r = client.chat.completions.create(
            model="gpt-5",
            messages=[{"role": "user", "content": "one liner pun about Linux"}]
        )
        print(r.choices[0].message.content)
    """)
    print(out.stdout)

with Sandbox() as sb:
    # Expensive setup once
    sb.run_code("""
        import pandas as pd
        df = pd.read_csv('https://raw.githubusercontent.com/pandas-dev/pandas/main/pandas/tests/io/data/csv/tips.csv')
        print(f'loaded {len(df)} rows')
    """)

    # Agent turn 2: `df` is still here, no re-loading
    out = sb.run_code("print(df.groupby('sex')['tip'].mean())")
    print(out.stdout)

    # Turn 3: import something new, use it, state sticks
    sb.run_code("import numpy as np")
    out = sb.run_code("print(np.array([1,2,3]).sum())")
    print(out.stdout)  # 6

with Sandbox() as sb:
    # Write a file from your agent loop
    sb.upload(b"hello from outside\n", "/tmp/greeting.txt")

    # Guest code reads + writes files like any Linux box
    sb.run_code("""
        cat /tmp/greeting.txt
        mkdir -p /app
        cd /app
        git clone --depth 1 https://github.com/psf/requests.git
        ls requests/
    """, language="bash")

    # Pull an artifact back out
    rendered = sb.download("/tmp/greeting.txt")
    print(rendered.decode())

with Sandbox() as parent:
    # Expensive setup: load a big DataFrame
    parent.run_code("""
        import pandas as pd
        df = pd.read_parquet('/data/big.parquet')  # 500 MB in memory
    """)

    # Fork 5 ways — each child inherits df without re-loading
    children = parent.fork(n=5)
    plans = [
        "df.groupby('region').revenue.sum()",
        "df.describe()",
        "df.corr(numeric_only=True)",
        "df['signup_date'].dt.year.value_counts()",
        "df.sample(100).to_json()",
    ]
    results = [c.run_code(p) for c, p in zip(children, plans)]

    # Pick the best branch, commit it as the parent's new state
    winner = children[pick_best(results)]
    parent.merge_into(winner)

    # The parent now IS winner's world. Losers get destroyed:
    for c in children:
        if c is not winner:
            c.close()

from podflare import Sandbox

# Create a long-running sandbox
sb = Sandbox(persistent=True)
sb.run_code("""
    import pandas as pd
    model = train_giant_model()   # 10 minutes
    df = load_big_dataset()       # 3 minutes
""")
# ... idle for 30 minutes, you go to lunch ...
# Reaper freezes it. Your dashboard shows a new Space.

# Later — same or different day — resume.
space_id = "<id from dashboard>"
sb = Sandbox.resume(space_id, region="us-west")

# `model` and `df` are still in memory. No re-training, no re-loading.
sb.run_code("print(model.predict(df.sample(10)))")

sb_usw = Sandbox(region="us-west")   # Latitude SJC
sb_eu  = Sandbox(region="eu")        # Hetzner Helsinki

# Go direct-to-origin (skip the edge). Only faster when your caller
# is in the same DC as the region; from residential wifi the edge
# is usually faster because CF's PoP is closer than the origin.
sb_fast = Sandbox(host="https://usw1.podflare.ai")

pip install podflare

import os
from podflare import Sandbox

# Create a key at https://dashboard.podflare.ai/keys
os.environ["PODFLARE_API_KEY"] = "pf_live_..."

with Sandbox() as sb:
    sb.run_code("pip install cowsay", language="bash")
    out = sb.run_code("import cowsay; cowsay.cow('podflare')")
    print(out.stdout)