islo 0.2.0

Typed Python SDK for the Islo sandbox platform

Islo Python SDK

Typed Python SDK for the Islo sandbox platform. Create, manage, and execute code in isolated VM-based sandboxes.

Installation

pip install islo

Quick Start

from islo import Islo

# Automatically reads ISLO_API_KEY from environment
client = Islo()

# Create a sandbox
sandbox = client.sandboxes.create_sandbox(
    name="my-sandbox",
    image="ubuntu:22.04",
    vcpus=2,
    memory_mb=4096,
)

# Execute a command
result = client.sandboxes.exec_in_sandbox(
    sandbox_name=sandbox.name,
    command=["echo", "hello world"],
)
print(result.exit_code)

# Clean up
client.sandboxes.delete_sandbox(sandbox_name=sandbox.name)

Authentication

Environment variable (recommended)

export ISLO_API_KEY="your-api-key"

client = Islo()  # Picks up ISLO_API_KEY automatically

Explicit token

client = Islo(token="your-api-key")

Auto-refreshing token provider

from islo import Islo
from islo.custom import SyncTokenProvider

provider = SyncTokenProvider(
    base_url="https://api.islo.dev",
    access_key="your-access-key",
)
client = Islo(token=provider)

Configuration

Environment Variable	Description	Default
ISLO_API_KEY	Bearer token for authentication	—
ISLO_BASE_URL	API base URL	https://api.islo.dev

Async Support

import asyncio
from islo import AsyncIslo

async def main():
    client = AsyncIslo()
    sandboxes = await client.sandboxes.list_sandboxes()
    print(f"Found {len(sandboxes.items)} sandboxes")

asyncio.run(main())

Development

# Install dependencies
uv sync --dev

# Run tests
uv run pytest tests/ -v

# Lint
uv run ruff check .
uv run ruff format --check .

Regenerating the SDK

The SDK is generated from the Islo API's OpenAPI spec using Fern:

# Export fresh OpenAPI spec from islo-web-api
cd ../islo-web-api
uv run python -c "import json; from src.api import app; json.dump(app.openapi(), open('../islo-sdk/fern/openapi/openapi.json', 'w'), indent=2)"

# Regenerate
cd ../islo-sdk
fern generate --group python-sdk

# Run tests to verify
uv run pytest tests/ -v

Custom code in src/islo/client.py and src/islo/custom/ is preserved across regenerations via .fernignore.