Quickstart

npm install @iris/sdk

pnpm add @iris/sdk

yarn add @iris/sdk

pip install irisrun

import { Sandbox } from '@iris/sdk'

async function main() {
  const sandbox = await Sandbox.create()

  console.log('Sandbox created:', sandbox.id)

  const result = await sandbox.exec.run('echo "Hello from Iris!"')
  console.log(result.stdout) // "Hello from Iris!\n"

  await sandbox.delete()
}

main()

from iris import IrisClient

client = IrisClient()  # reads IRIS_API_KEY from environment
sandbox = client.sandboxes.create()

print("Sandbox created:", sandbox.id)

result = sandbox.exec.run(["echo", "Hello from Iris!"])
print(result.stdout)  # "Hello from Iris!\n"

sandbox.delete()

import { Sandbox } from '@iris/sdk'

async function main() {
  const sandbox = await Sandbox.create()

  // Install dependencies
  await sandbox.exec.run('apt-get install -y python3-numpy')

  // Save this state
  const cp = await sandbox.checkpoint.create({ name: 'deps-installed' })
  console.log('Checkpoint saved:', cp.checkpoint_id)

  // Fork to run something risky — original sandbox is untouched
  const branch = await sandbox.fork()
  await branch.exec.run('python3 -c "import os; os.system(\"rm -rf /tmp\")"')
  await branch.delete()

  // Original sandbox still has numpy
  const check = await sandbox.exec.run('python3 -c "import numpy; print(numpy.__version__)"')
  console.log(check.stdout)

  await sandbox.delete()
}

main()

from iris import IrisClient

client = IrisClient()
sandbox = client.sandboxes.create()

# Install dependencies
sandbox.exec.run(["bash", "-c", "apt-get install -y python3-numpy"])

# Save this state
cp = sandbox.checkpoint.create(name="deps-installed")
print("Checkpoint saved:", cp.checkpoint_id)

# Fork to run something risky — original sandbox is untouched
branch = sandbox.fork()
branch.exec.run(["bash", "-c", "rm -rf /tmp"])
branch.delete()

# Original sandbox still has numpy
check = sandbox.exec.run(["python3", "-c", "import numpy; print(numpy.__version__)"])
print(check.stdout)

sandbox.delete()