Wykonanie kodu jednym wywołaniem
Każdy sandbox to microVM Firecracker z własnym jądrem Linuksa i rootem w środku, uruchamiana z naszego szablonu base w ok. 0,15 s: to Ubuntu 24.04 z narzędziami do budowania, Pythonem 3, Node.js 22 i Dockerem. run_command uruchamia polecenie przez bash -lc jako user, który ma sudo, albo jako root, w dowolnym wskazanym katalogu. Wywołanie czeka do 45 sekund na koniec polecenia i odpowiada jego kodem wyjścia oraz ostatnimi 32 KiB jego stdout i stderr.
Trzy pola zmieniają to, na co czeka wywołanie:
wait_for_portodpowiada, gdy tylko coś zacznie nasłuchiwać na porcie, a polecenie działa dalej:npm run devi 5173.wait_seconds=0odpowiada, gdy polecenie wystartuje.get_commandznowu na nie czeka, awatch_commandprzesyła jego wynik na żywo: najpierw ostatnie 64 KiB, potem to, co przychodzi.timeout_secondskończy polecenie, które działa za długo. Bez niego polecenie kończy tylkostop_command: SIGTERM, a 10 s później SIGKILL.
Każda odpowiedź mówi, ile bajtów polecenie już wypisało; odeślij tę liczbę, a następna odpowiedź zawiera tylko to, co nowe. Z request_id ponowienie w ciągu 24 godzin niczego nie uruchamia drugi raz i odpowiada tym, co zrobiło pierwsze wywołanie. list_commands pokazuje, co teraz działa, łącznie z poleceniami wpisanymi przez SSH, a 100 ostatnich zakończonych zostaje zachowanych.
from pethost.sandboxes import FileChange, Sandboxes, TextEdit
sandboxes = Sandboxes() # czyta PETHOST_TOKEN
box = sandboxes.create_sandbox()
code = "x = 1\nprint(x * 42)\n"
sandboxes.write_files(box.sandbox_id, changes=[FileChange(path="app.py", text=code)])
out = sandboxes.run_command(box.sandbox_id, command="python3 app.py", timeout_seconds=30)
print(out.exit_code, out.stdout) # 0 42
edit = TextEdit(old_text="x = 1", new_text="x = 2")
sandboxes.write_files(box.sandbox_id, changes=[FileChange(path="app.py", edit=edit)])
server = sandboxes.run_command(box.sandbox_id, command="python3 -m http.server 8000",
wait_for_port=8000)
print(server.state.name) # RUNNING: odpowiedziało, gdy port 8000 zaczął nasłuchiwaćpethost sandbox new --name tests --size small
pethost sandbox cp ./app tests:/home/user/app
pethost sandbox run tests --cwd /home/user/app -- python3 -m unittest
pethost sandbox open tests --terminalPliki: paczki zmian i dokładne edycje
write_files przyjmuje listę zmian i wykonuje je po kolei: zapis tekstu albo bajtów pliku, zamiana tekstu, który występuje w nim dokładnie raz, przeniesienie, usunięcie, utworzenie katalogu, ustawienie uprawnień. Brakujące katalogi nadrzędne są tworzone. Zatrzymuje się na pierwszej zmianie, która się nie uda, i mówi, na której, z powodem, na którym można oprzeć logikę, na przykład że tekstu do zamiany nie ma. Edycja trafia więc tylko tam, gdzie jest jej tekst. Żądanie mieści do 17 MiB.
read_file czyta do 1 MiB od dowolnego przesunięcia, list_files wypisuje katalog na dowolną głębokość, a watch_files przesyła na żywo każdą zmianę pod nim. Plik dowolnej wielkości przechodzi przez link z create_link: adres pobierania wysyła plik albo katalog jako .tar, a adres wgrywania przyjmuje PUT. Każdy działa raz.
Terminal w przeglądarce
create_link z terminalem daje stronę, na której działa bash albo polecenie takie jak claude, i WebSocket pod tym samym adresem, który przenosi jego bajty, do terminala we własnym produkcie. Link działa domyślnie godzinę, a najwyżej dzień.
Co działa w środku
Docker działa w każdym sandboxie: dockerd startuje przy pierwszym połączeniu z jego gniazdem i trzyma obrazy na dysku sandboxa, więc przetrwają zatrzymanie, a szablon je przeniesie. Resztę zainstalujesz z apt, przez sudo.
Wywołania idą prosto do serwera sandboxa, który SDK znajduje za ciebie. Pierwsze polecenie po utworzeniu odpowiada w 29–48 ms. Na serwerze z 74 sandboxami, z których każdy budował projekt JavaScript i czekał między buildami, tak jak agent, proste polecenie trwało 6 ms (28 ms w 95. percentylu).
Limity i ceny
| Co | Limit |
|---|---|
| Wywołania naraz, na sandbox | 64; write_files liczy się za 16 |
| Żądanie | 1 MiB; write_files 17 MiB |
| Odpowiedź | ok. 64 KiB; read_file 1 MiB; dowolna wielkość przez link |
| Wynik w odpowiedzi | ostatnie 32 KiB stdout i stderr |
Polecenia, pliki i linki nie mają własnej ceny: płacisz za sekundy działania sandboxa, od 0,018 $ za godzinę dla SMALL (2 vCPU, 4 GiB) do 0,144 $ dla XLARGE (16 vCPU, 32 GiB), a każdy okres działania zaokrąglamy w górę do sekundy, minimum 10 s. Po 5 minutach bezczynności sandbox wstrzymuje się za 30% tej ceny. Jak działa rozliczanie co do sekundy.
Jak to wypada na tle innych
21 listopada 2026 E2B liczyło 0,1656 $ za godzinę sandboxa z 2 vCPU i 4 GiB, tak samo Daytona; SMALL w Pethost, tego samego rozmiaru, kosztuje 0,018 $. Sesje w E2B trwały do 1 godziny w planie Hobby i do 24 godzin w planie Pro, w Vercel Sandbox 45 minut w planie Hobby i 24 godziny w planie Pro. Sandbox Pethost nie ma limitu czasu życia.