Daytona

​

Installation

pip install 'mirage-ai[daytona]'

pnpm add @daytonaio/sdk

​

Usage

from mirage import RAMVFS, MountMode, Workspace
from mirage.runtime.machine import MachineRuntime

ws = Workspace(
    {"/data": RAMVFS()},
    mode=MountMode.EXEC,
    machines={"box": {"provider": "daytona", "sandbox_id": "sandbox-id"}},
    runtimes=[MachineRuntime(["@python", "@external"], machine="box")],
)
await ws.shell("python3 -c 'print(1 + 1)'")

import { MountMode, MachineRuntime, RAMVFS, Workspace } from '@struktoai/mirage-node'

const ws = new Workspace(
  { '/data': new RAMVFS() },
  {
    mode: MountMode.EXEC,
    machines: { box: { provider: 'daytona', sandboxId: 'sandbox-id' } },
    runtimes: [new MachineRuntime({ captures: ['@python', '@external'], machine: 'box' })],
  },
)
await ws.shell("python3 -c 'print(1 + 1)'")

mode: exec
machines:
  box:
    provider: daytona
    sandbox_id: ${DAYTONA_SANDBOX_ID}
runtimes:
  - name: machine
    captures: ["@python", "@external"]
    machine: box
mounts:
  /data:
    vfs: ram

​

Connecting the workspace

mounts:
  /data:
    vfs: s3
    config:
      bucket: my-bucket
    backend: fuse
    mountpoint: /data

mirage workspace create /tmp/sandbox.yaml

• This workspace’s mount modes and permissions do not reach those files; sandbox.yaml decides.
• Keep the sandbox’s paths in step with the host’s mounts yourself.

​

Runtime behavior

​

Notes

• Closing the workspace leaves the sandbox running.
• Output comes back as the program wrote it, binary included: the sandbox base64-encodes it on the way out, so the image needs dd and base64 (Debian, Ubuntu and Alpine images have both), and output takes about a third more to transfer. Without them a line runs nothing, prints why and exits 127.
• Sizing, GPUs, snapshots, networking, idle-stop and auto-delete stay Daytona settings. The Daytona example covers baking a snapshot and a full read and write round trip.
• A Daytona sandbox has no timeout of its own: after a Mirage timeout, the program keeps running and billing until you stop it.