How can I make Sandbox.create non-blocking when creating a sandbox?

[big-cooper]

Description When using the Python SDK to create a sandbox, the await Sandbox.create(image, ...) call blocks until the sandbox creation is complete. I am looking for a way to make this operation non-blocking so execution can continue immediately.

sandbox = await Sandbox.create(
    image,
    ...
)

Attempts Made I tried setting the skip_health_check=True parameter, but it seems this does not bypass the blocking stage during creation.

Expected Behavior The Sandbox.create method should return immediately without waiting for the sandbox to be fully ready, or there should be an alternative asynchronous method to initiate creation without blocking.

Actual Behavior The SDK waits for the sandbox creation to complete and blocks the execution flow at the await statement.

Environment

SDK Version: [0.1.5]
Python Version: [3.12.8]
Image: enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:1.0.0.150

[ninan-nn]

Thanks for reporting this.

Today in the Python SDK, skip_health_check=True only skips the readiness polling (check_ready(...)), but await Sandbox.create(...) still needs to finish lifecycle calls (create sandbox + resolve endpoint), so it is still awaited by design.

If you want your coroutine to continue immediately, you can run creation in a background task:

task = asyncio.create_task(
    Sandbox.create(
        image,
        skip_health_check=True,
    )
)

# continue doing other work...

sandbox = await task

Also, we’re working on an alternative client-side design in PR #393:
#393

That PR introduces a client SandboxPool (currently in development/experimental) so callers can acquire pre-created sandboxes, which can reduce or hide creation latency in many scenarios.