Quickstart

pip install sail
# or
uv add sail

sail auth login

import sail


app = sail.App.find(name="sailbox-quickstart", mint_if_missing=True)

sb = sail.Sailbox.create(app=app, name="quickstart")

result = sb.run("python3 -c 'print(\"hello world\")'")
print(result.stdout)

sb.fs.write("/tmp/note.txt", "from my machine")
print(sb.fs.read("/tmp/note.txt").decode())

sb.terminate()

python quickstart.py

npm install @sailresearch/sdk
npm install --save-dev tsx

# macOS and Linux
curl -fsSL https://cli.sailresearch.com/install.sh | sh

# Windows PowerShell
irm https://cli.sailresearch.com/install.ps1 | iex

sail auth login

import { App, Sailbox } from "@sailresearch/sdk";

async function main() {
  const app = await App.find("sailbox-quickstart", { mintIfMissing: true });

  const sb = await Sailbox.create({ app, name: "quickstart" });

  try {
    const hello = await sb.run(["python3", "-c", "print('hello world')"]);
    console.log(hello.stdout);

    await sb.fs.write("/tmp/note.txt", "from my machine");
    console.log((await sb.fs.read("/tmp/note.txt")).toString());
  } finally {
    await sb.terminate();
  }
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

npx tsx quickstart.ts

cargo new hello-sail && cd hello-sail
cargo add sail-rs
cargo add tokio --features macros,rt-multi-thread

# macOS and Linux
curl -fsSL https://cli.sailresearch.com/install.sh | sh

# Windows PowerShell
irm https://cli.sailresearch.com/install.ps1 | iex

sail auth login

use sail::{
    BaseImage, Client, CreateSailboxRequest, ImageArchitecture, ImageSpec, RunOptions, SailError,
    WriteOptions,
};

#[tokio::main]
async fn main() -> Result<(), SailError> {
    let client = Client::from_env()?;

    let app = client
        .find_app("sailbox-quickstart", /* mint_if_missing */ true)
        .await?;

    let sb = client
        .create_sailbox(
            &CreateSailboxRequest {
                app_id: app.id,
                name: "quickstart".into(),
                image: ImageSpec {
                    base: Some(BaseImage::Debian),
                    architecture: ImageArchitecture::Arm64,
                    ..Default::default()
                },
                ..Default::default()
            },
            /* timeout */ None,
        )
        .await?;

    let result = async {
        let hello = sb
            .run(
                ["python3", "-c", "print('hello world')"],
                RunOptions::default(),
            )
            .await?;
        print!("{}", hello.stdout);

        sb.fs()
            .write("/tmp/note.txt", b"from my machine", WriteOptions::default())
            .await?;
        let note = sb.fs().read("/tmp/note.txt").await?;
        println!("{}", String::from_utf8_lossy(&note));

        Ok::<(), SailError>(())
    }
    .await;

    let terminate_result = sb.terminate().await;
    result?;
    terminate_result?;
    Ok(())
}

cargo run