Sandboxes Python client

cwsandbox Python 클라이언트는 CoreWeave 샌드박스 환경을 생성하고 관리하기 위한 고수준 SDK를 제공합니다. 통합 API를 통해 동기 및 비동기 워크플로를 모두 지원합니다.

Python 환경 준비

uv를 설치하세요. 프로젝트 디렉터리에서 Python 3.11 이상의 기존 가상 환경을 활성화하거나 새 가상 환경을 만드세요.

uv venv --python 3.12
source .venv/bin/activate

이 환경에서 설치 명령어와 예시 스크립트를 실행하세요.

인증 선택

섹션에서 CKS를 지정하지 않는 한, 이 예시는 서버리스 용량에서 실행됩니다. 샌드박스를 소유한 계정의 사용자 인증 정보를 선택하세요. 키 또는 토큰을 획득하는 방법은 사용자 인증 정보 선택 및 조회를 참조하세요. 사용 중인 사용자 인증 정보 탭의 Python 코드를 sandbox_auth.py라는 이름으로, 이 페이지에서 실행할 Python script와 같은 위치에 저장하세요. 이 파일에는 사용자 인증 정보 자체가 아니라 어떤 인증 방식을 사용할지만 저장됩니다. 예시에서는 이 파일에서 AUTH를 임포트하여 새로 만드는 각 샌드박스 또는 세션에 명시적으로 전달합니다.

Forge API 키
CoreWeave API 액세스 토큰

SDK의 W&B 인증 전략을 통해 Forge API 키를 사용하세요.

uv pip install 'cwsandbox[wandb]>=1.14.2'
export WANDB_API_KEY="[WANDB-API-KEY]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.WANDB

CoreWeave 조직의 토큰을 사용하세요.

uv pip install 'cwsandbox>=1.14.2'
export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.COREWEAVE_API_KEY

CKS 배치를 사용하려면 CoreWeave 토큰을 선택하고 러너를 활성화한 다음, 샌드박스를 생성할 때 또는 SandboxDefaults에서 placement_mode="cks"를 설정하세요. auth=AUTH로 세션을 생성하면 해당 세션이 소유한 샌드박스도 함께 인증됩니다. 샌드박스에 다시 연결하거나 목록을 조회하거나 정리할 때도 동일한 사용자 인증 정보를 사용하세요.

빠른 시작

샌드박스를 생성하고 명령어를 실행한 다음 결과를 가져오세요:

from sandbox_auth import AUTH
from cwsandbox import Sandbox

# 자동 정리를 위한 컨텍스트 관리자
with Sandbox.run(
    container_image="python:3.11",
    resources={"cpu": "1", "memory": "1Gi"},
    auth=AUTH,
) as sb:
    result = sb.exec(["python", "-c", "print(2 + 2)"]).result()
    print(result.stdout)  # 4

비동기 코드에서는 Sandbox(...)를 async with와 함께 사용하면 이벤트 루프를 차단하지 않고 샌드박스를 시작할 수 있습니다. Sandbox.run()은 내부적으로 start().result()를 호출하므로 시작하는 동안 실행이 차단됩니다. 자세한 내용은 동기 및 비동기 패턴을 참조하세요.

from sandbox_auth import AUTH
from cwsandbox import Sandbox

async with Sandbox(resources={"cpu": "1", "memory": "1Gi"}, auth=AUTH) as sb:
    result = await sb.exec(["python", "-c", "print(2 + 2)"])
    print(result.stdout)  # 4

다음 단계

CLI 가이드를 참고하여 터미널에서 기존 샌드박스를 관리하세요.

시작하기

인증을 완료하고 SDK로 첫 번째 서버리스 샌드박스를 실행해 보세요.

튜토리얼

Python SDK로 샌드박스를 설정하고, 명령어를 실행하고, 파일을 전송한 뒤 정리하는 방법을 알아보세요.

가이드

라이프사이클 관리, 파일 오퍼레이션, 실행 패턴, 문제 해결 등 주제별 심층 가이드입니다.

샌드박스

샌드박스 사용하기

샌드박스 관리

레퍼런스

Python 환경 준비

인증 선택

빠른 시작

다음 단계

시작하기

튜토리얼

가이드

​Python 환경 준비

​인증 선택

​빠른 시작

​다음 단계

시작하기

튜토리얼

가이드

Python 환경 준비

인증 선택

빠른 시작

다음 단계