blaxel

What it is and what it does

Blaxel is a Python SDK for interacting with Blaxel's perpetual sandbox platform—a managed compute service that keeps secure sandboxes on standby for near-instant launch. The SDK lets you programmatically create sandboxes, execute processes, manage filesystems, attach persistent volumes, and generate preview URLs for web services running inside them. It supports both async and sync APIs and handles pagination for list operations.

The platform is designed for AI agent development and deployment, with co-hosted agent logic to reduce network latency. Authentication is automatic when using the Blaxel CLI or can be configured via environment variables or a config file. The default sandbox image is Alpine Linux with Node.js 22 and git; Python must be explicitly installed or a Python-specific image selected.

Use it for:

• Deploy and manage AI agents in isolated, auto-scaling sandbox environments with minimal startup overhead.
• Execute long-running or batch processes (builds, data pipelines) in ephemeral containers that scale to zero after inactivity.
• Generate temporary public or private preview URLs to test web services or APIs running inside sandboxes.
• Persist application state and data across sandbox restarts using attached volumes.
• Programmatically manage sandbox lifecycle (create, monitor, delete) as part of a larger orchestration workflow.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python SDK for creating, managing, and executing workloads in Blaxel's perpetual sandbox platform, with support for process execution, filesystem operations, volumes, and preview URLs.

Yes, if you are building on the Blaxel platform or need a Python interface to its sandbox infrastructure. The SDK is actively maintained, has low install friction, and covers core sandbox operations. However, verify the license terms first—they are not declared in the package metadata—and ensure your use case aligns with Blaxel's pricing and authentication model.

Install

blaxel on PyPI

pip install blaxel

uv add blaxel

poetry add blaxel

Installing blaxel

Before you install

Low install friction with a pure-Python wheel. Active maintenance with recent releases; last commit 2026-08-14. Requires Python 3.10–3.14 and 11 runtime dependencies including httpx, pydantic, and websockets.

License in practice

License treatment is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in proprietary or commercial projects.

Quickstart

pip install blaxel

import asyncio
from blaxel.core import SandboxInstance

async def main():
    sandbox = await SandboxInstance.create_if_not_exists({
        "name": "my-sandbox",
        "image": "blaxel/base-image:latest",
        "memory": 4096
    })
    await sandbox.delete()

asyncio.run(main())

Requires Blaxel workspace authentication via Blaxel CLI login, environment variables (BL_WORKSPACE, BL_API_KEY), or config file (~/.blaxel/config.yaml).

Verify before relying

• Whether the default base image includes Python or requires explicit installation for Python workloads.
• Exact behavior and latency guarantees for sandbox startup and resumption times.
• Rate limits or quotas on sandbox creation, process execution, or API calls.
• Data retention and cleanup policies for volumes and sandbox state.

Package facts

Evidence: blaxel-0.4.1-py3-none-any.whl

Tags

More Distributed Computing packages