Python SDK

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.

# Base package (core functionality)
pip install blaxel

# With specific modules
pip install "blaxel[telemetry]"
pip install "blaxel[core,telemetry,crewai]"

# Everything
pip install "blaxel[all]"

Available modules

blaxel.core - Core functionality (always available)
blaxel.telemetry - Telemetry and monitoring
blaxel.crewai - CrewAI integration
blaxel.openai - OpenAI integration
blaxel.langgraph - LangGraph integration
blaxel.livekit - LiveKit integration
blaxel.llamaindex - LlamaIndex integration
blaxel.pydantic - Pydantic AI integration
blaxel.googleadk - Google ADK integration

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.2.11rc89

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.2.11rc89
File	Size	Uploaded
blaxel-0.2.11rc89.tar.gz	268.0 kB	Aug 6, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for blaxel 0.2.11rc89
File	Interpreter	ABI	Platform	Reset
blaxel-0.2.11rc89-py3-none-any.whl 419.1 kB Aug 6, 2025	Python 3	none	any	Details

Total release size: 687.2 kB

Release files / blaxel-0.2.11rc89.tar.gz

Download URL	blaxel-0.2.11rc89.tar.gz
Size	268.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`4f523a2110f54b20edec59a17463a4a745ca2d99c5c07ace19cdbc61407a9d36`
BLAKE2b-256 checksum How to use checksums	`aa77fd083776db7d1268f5b4112fa8ccf35d6cc205827ba06f42f3ed761da100`
Upload date	Aug 6, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.8.5`

Release files / blaxel-0.2.11rc89-py3-none-any.whl

Download URL	blaxel-0.2.11rc89-py3-none-any.whl
Size	419.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`680924263526d8cd49e80f4e316b84ff8f34dc61f5fdb4f90dfa3c1c33a798f0`
BLAKE2b-256 checksum How to use checksums	`7695306bdbc6604adb0fcf91408ea4eb2b61b8395af10131604a6498ebce83a2`
Upload date	Aug 6, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.8.5`