Upload & downloads files

E2B Sandbox allows you to upload and downloads file to and from the Sandbox. An alternative way to get your data to the sandbox is to create a custom sandbox template.

Upload file

import fs from 'fs'
import { Sandbox } from 'e2b'

// Read local file relative to the current working directory
const content = fs.readFileSync('local/file')

const sbx = await Sandbox.create()
// Upload file to the sandbox to absolute path '/home/user/my-file'
await sbx.files.write('/home/user/my-file', content)

from e2b import Sandbox

sbx = Sandbox.create()

# Read local file relative to the current working directory
with open("local/file", "rb") as file:
   # Upload file to the sandbox to absolute path '/home/user/my-file'
	sbx.files.write("/home/user/my-file", file)

Upload multiple files

To upload multiple files in one call, pass a list of { path, data } entries to files.write() in JavaScript or to files.write_files() in Python. See Upload data to sandbox. The following example shows the other approach, with one files.write() call per file.

import fs from 'fs'
import { Sandbox } from 'e2b'

// Read local file relative to the current working directory
const fileA = fs.readFileSync('local/file/a')
const fileB = fs.readFileSync('local/file/b')

const sbx = await Sandbox.create()
// Upload file A to the sandbox to absolute path '/home/user/my-file-a'
await sbx.files.write('/home/user/my-file-a', fileA)
// Upload file B to the sandbox to absolute path '/home/user/my-file-b'
await sbx.files.write('/home/user/my-file-b', fileB)

from e2b import Sandbox

sbx = Sandbox.create()

# Read local file relative to the current working directory
with open("local/file/a", "rb") as file:
   # Upload file to the sandbox to absolute path '/home/user/my-file-a'
	sbx.files.write("/home/user/my-file-a", file)

with open("local/file/b", "rb") as file:
   # Upload file to the sandbox to absolute path '/home/user/my-file-b'
	sbx.files.write("/home/user/my-file-b", file)

Upload directory

We currently don’t support an easy way to upload a whole directory. You can read each file locally and pass the files in one call to files.write() in JavaScript or files.write_files() in Python. See Upload data to sandbox. We’re working on a better solution.

Download file

To download a file, you need to first get the file’s content and then write it to a local file.

import fs from 'fs'
import { Sandbox } from 'e2b'

const sbx = await Sandbox.create()
// Download file from the sandbox to absolute path '/home/user/my-file'
const content = await sbx.files.read('/home/user/my-file')
// Write file to local path relative to the current working directory
fs.writeFileSync('local/file', content)

from e2b import Sandbox

sbx = Sandbox.create()
# Download file from the sandbox to absolute path '/home/user/my-file'
content = sbx.files.read('/home/user/my-file')
# Write file to local path relative to the current working directory
with open('local/file', 'w') as file:
    file.write(content)

Download multiple files

To download multiple files, you need to download each one of them separately from the sandbox. We’re working on a better solution.

import fs from 'fs'
import { Sandbox } from 'e2b'

const sbx = await Sandbox.create()
// Download file A from the sandbox by absolute path '/home/user/my-file-a'
const contentA = await sbx.files.read('/home/user/my-file-a')
// Write file A to local path relative to the current working directory
fs.writeFileSync('local/file/a', contentA)

// Download file B from the sandbox by absolute path '/home/user/my-file-b'
const contentB = await sbx.files.read('/home/user/my-file-b')
// Write file B to local path relative to the current working directory
fs.writeFileSync('local/file/b', contentB)

from e2b import Sandbox

sbx = Sandbox.create()
# Download file A from the sandbox by absolute path '/home/user/my-file-a'
contentA = sbx.files.read('/home/user/my-file-a')
# Write file A to local path relative to the current working directory
with open('local/file/a', 'w') as file:
    file.write(contentA)

# Download file B from the sandbox by absolute path '/home/user/my-file-b'
contentB = sbx.files.read('/home/user/my-file-b')
# Write file B to local path relative to the current working directory
with open('local/file/b', 'w') as file:
    file.write(contentB)

Download directory

We currently don’t support an easy way to download a whole directory. You need to download each file separately. We’re working on a better solution.

​Upload file

​Upload multiple files

​Upload directory

​Download file

​Download multiple files

​Download directory