Blaxel Python SDK

Blaxel

Blaxel is a computing platform for AI agent builders, with all the services and infrastructure to build and deploy agents efficiently. This repository contains the Python SDK to create and manage resources on Blaxel.

Installation
- Authentication
Features
Quickstart
Contributing
License

Installation

Install Blaxel SDK which lets you manage Blaxel resources.

## Using pip
pip install blaxel

## Using uv
uv pip install blaxel

## Using uv add
uv add blaxel

Authentication

The Blaxel SDK authenticates with your workspace using credentials from these sources, in priority order:

When running on Blaxel, authentication is handled automatically
Variables in your .env file (BL_WORKSPACE and BL_API_KEY, or see this page for other authentication options).
Environment variables from your machine
Configuration file created locally when you log in through Blaxel CLI (or deploy on Blaxel)

When developing locally, the recommended method is to just log in to your workspace with Blaxel CLI. This allows you to run Blaxel SDK functions that will automatically connect to your workspace without additional setup. When you deploy on Blaxel, this connection persists automatically.

When running Blaxel SDK from a remote server that is not Blaxel-hosted, we recommend using environment variables as described in the third option above.

Features

Agents & MCP servers
Sandboxes
- Create and update sandboxes and sandbox previews
- Run filesystem operations and processes on a sandbox
Use environment variables or secrets

Quickstart

Blaxel CLI gives you a quick way to create new applications: agents, MCP servers, jobs, etc - and deploy them to Blaxel.

Prerequisites:

Node.js: v18 or later.

Blaxel CLI: Make sure you have Blaxel CLI installed. If not, install it:

curl -fsSL \
https://raw.githubusercontent.com/blaxel-ai/toolkit/main/install.sh \
| BINDIR=/usr/local/bin sudo -E sh

Blaxel login: Login to Blaxel:
```
  bl login YOUR-WORKSPACE
```

bl create-agent-app myfolder
cd myfolder
bl deploy

Also available:

bl create-mcp-server
bl create-job

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Metadata

Release files for blaxel 0.1.20rc68

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for blaxel 0.1.20rc68
File	Size	Uploaded
blaxel-0.1.20rc68.tar.gz	202.0 kB	May 30, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for blaxel 0.1.20rc68
File	Interpreter	ABI	Platform	Reset
blaxel-0.1.20rc68-py3-none-any.whl 366.1 kB May 30, 2025	Python 3	none	any	Details

Total release size: 568.1 kB

Release files / blaxel-0.1.20rc68.tar.gz

Download URL	blaxel-0.1.20rc68.tar.gz
Size	202.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`52dcc8ddaa8e274258334cd85f1fc1bb19319811ab84896c5a52d3cf47fc372c`
BLAKE2b-256 checksum How to use checksums	`30f645dd733c71f4fd7f01b0a9f19038c63da0db2769573a88be094a9de5ba13`
Upload date	May 30, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.7.8`

Release files / blaxel-0.1.20rc68-py3-none-any.whl

Download URL	blaxel-0.1.20rc68-py3-none-any.whl
Size	366.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`09812dd77ef4a8924784ba616de8db56a9e1d2d35f505c48436a527a8a45c31d`
BLAKE2b-256 checksum How to use checksums	`50319d3746a6076fb2ba1907bd9c19dc271e246e176cb3d7fc5582c12c18913b`
Upload date	May 30, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.7.8`