Getting Started with the Fermion Sandbox

import { Sandbox } from '@fermion-app/sandbox'

async function main() {
  // Initialize the sandbox with your API key
  const sandbox = new Sandbox({
    apiKey: process.env.FERMION_API_KEY
  })

  try {
    // Create a new container
    console.log('Creating sandbox...')
    const snippetId = await sandbox.create({
      shouldBackupFilesystem: false // Files won't persist after disconnect
    })
    console.log('Sandbox created! Snippet ID:', snippetId)

    // Run a simple command
    console.log('\nRunning node --version...')
    const nodeVersion = await sandbox.runCommand({
      cmd: 'node',
      args: ['--version']
    })
    console.log('Node version:', nodeVersion.stdout.trim())

    // Write a file
    console.log('\nWriting hello.js...')
    await sandbox.writeFile({
      path: '/home/damner/hello.js',
      content: 'console.log("Hello from Fermion Sandbox!")'
    })
    console.log('File written')

    // Execute the file (~/ works in commands, shell expands it)
    console.log('\nExecuting hello.js...')
    const output = await sandbox.runCommand({
      cmd: 'node',
      args: ['~/hello.js']
    })
    console.log('Output:', output.stdout.trim())

    // Read the file back
    console.log('\nReading hello.js...')
    const fileResponse = await sandbox.getFile('/home/damner/hello.js')
    const fileContent = await fileResponse.text()
    console.log('File contents:', fileContent)

  } catch (error) {
    console.error('Error:', error.message)
  } finally {
    // Always clean up
    console.log('\nDisconnecting...')
    await sandbox.disconnect()
    console.log('Disconnected')
  }
}

main()

from fermion_sandbox import Sandbox
import os

def main():
    # Initialize the sandbox with your API key
    sandbox = Sandbox(api_key=os.getenv("FERMION_API_KEY"))

    # Create a new container
    print("Creating sandbox...")
    snippet_id = sandbox.create(should_backup_filesystem=False)  # Files won't persist after disconnect
    print(f"Sandbox created! Snippet ID: {snippet_id}")

    # Run a simple command
    print("\nRunning python3 --version...")
    python_version = sandbox.run_command(cmd="python3", args=["--version"])
    print("Python version:", python_version.stdout.strip())

    # Write a file
    print("\nWriting hello.py...")
    sandbox.write_file(path="~/hello.py", content='print("Hello from Fermion Sandbox!")')
    print("File written")

    # Execute the file
    print("\nExecuting hello.py...")
    output = sandbox.run_command(cmd="python3", args=["hello.py"])
    print("Output:", output.stdout.strip())

    # Read the file back
    print("\nReading hello.py...")
    file_response = sandbox.get_file("~/hello.py")
    file_content = file_response.text()
    print("File contents:", file_content)

    # Always clean up
    print("\nDisconnecting...")
    sandbox.disconnect()
    print("Disconnected")

if __name__ == "__main__":
    main()

Creating sandbox...
Sandbox created! Snippet ID: abc123xyz

Running node --version...
Node version: v20.11.0

Writing hello.js...
File written

Executing hello.js...
Output: Hello from Fermion Sandbox!

Reading hello.js...
File contents: console.log("Hello from Fermion Sandbox!")

Disconnecting...
Disconnected

Creating sandbox...
Sandbox created! Snippet ID: abcd-python-1234k

Running python3 --version...
Python version: Python 3.11.6

Writing hello.py...
File written

Executing hello.py...
Output: Hello from Fermion Sandbox!

Reading hello.py...
File contents: print("Hello from Fermion Sandbox!")

Disconnecting...
Disconnected