Blazing Agents Python SDK
Build production agents in Python with a typed client for the Blazing Agents API.
The official Python SDK provides synchronous and asynchronous clients for the
Blazing Agents /v1 API. It supports CPython 3.11 and newer.
Features
- Typed Pydantic request and response models.
- Matching synchronous and asynchronous APIs.
- Agent, Workspace, Skill, Provider, Prompt, Memory, Session, Artifact, Task, usage, and Tenant management.
- Chat, text, and structured-object generation streams.
- Lazy pagination and binary transfers.
- Request correlation with configurable timeouts and observability.
Installation
pip install blazing-agents
Quick start
Create a Tenant API key in the Blazing Agents dashboard, then pass it to the
client or set BLAZING_AGENTS_API_KEY.
from blazing_agents import BlazingAgents
with BlazingAgents(api_key="ba_...") as client:
result = client.completion(
agent_id="ag_...",
prompt="Write a friendly welcome message.",
)
print(str(result))
Use AsyncBlazingAgents for asynchronous applications; it exposes the same
resources and generation methods.
Documentation
Read the Python SDK documentation for authentication, resource guides, generation and streaming, error handling, and the complete API reference.
Thinking levels
Configure thinking_level on Agent create or update. Omit it on update to
preserve the current selection; pass None for Provider default. Explicit
levels are strings, including custom values for Models with unknown capabilities.
Agent and Agent Version responses expose thinking_level, and restoring a
Version restores its level too. The async client provides the same methods.
capabilities = client.providers.get_thinking_levels(provider_id, model="gpt-5")
# capabilities.known distinguishes unknown metadata from known choices.
agent = client.agents.create(
name="Reasoner",
provider_id=provider_id,
model="openai/gpt-5",
thinking_level="high",
)
client.agents.update(agent.id, thinking_level=None)
Development
uv sync --locked
uv run ruff check .
uv run ruff format --check .
uv run python scripts/run_typechecks.py
uv run python scripts/run_tests.py
License
Interactive resend
Successful interactive exchanges are saved together. Failed or canceled execution leaves saved history unchanged, including the previous answer during regeneration; executed usage and Tool effects remain. Retain submitted text/images until success and resend edited or unchanged input through ordinary chat with a fresh message ID. Stop requests cancellation; a lost response can hide a saved exchange. Reuse the returned Session ID and load history normally on return. No outcome polling or automatic generation retry is needed. See the chatbot guide and working examples.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file blazing_agents-0.2.0.tar.gz.
File metadata
- Download URL: blazing_agents-0.2.0.tar.gz
- Upload date:
- Size: 117.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
afa6747791296a42e86d1850abf2d06e49a8d017b1e11ad0cf09fc45ab1e2d9b
|
|
| MD5 |
19c3a3937f4d21f22fd88a1bb09eb707
|
|
| BLAKE2b-256 |
3bd92713af89eac6fc798da60bdab83780b6a9dee5232e3d5f95cf368eea2006
|
Provenance
The following attestation bundles were made for blazing_agents-0.2.0.tar.gz:
Publisher:
publish.yml on blazingagents/python-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
blazing_agents-0.2.0.tar.gz -
Subject digest:
afa6747791296a42e86d1850abf2d06e49a8d017b1e11ad0cf09fc45ab1e2d9b - Sigstore transparency entry: 2757303669
- Sigstore integration time:
-
Permalink:
blazingagents/python-sdk@5fe4d458800667414245c27cd1802566b756b3f0 -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/blazingagents
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@5fe4d458800667414245c27cd1802566b756b3f0 -
Trigger Event:
release
-
Statement type:
File details
Details for the file blazing_agents-0.2.0-py3-none-any.whl.
File metadata
- Download URL: blazing_agents-0.2.0-py3-none-any.whl
- Upload date:
- Size: 38.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4c7fd9ca0cb90501af2863b783a64489d7ae34afff850dd4fc09c94527d50513
|
|
| MD5 |
c5c942014c53072c7d0f5c152ed5a1ed
|
|
| BLAKE2b-256 |
47cbf9ec475b6dc2858370e5c66fed990384c5ab58b93844916916aa32fe1acb
|
Provenance
The following attestation bundles were made for blazing_agents-0.2.0-py3-none-any.whl:
Publisher:
publish.yml on blazingagents/python-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
blazing_agents-0.2.0-py3-none-any.whl -
Subject digest:
4c7fd9ca0cb90501af2863b783a64489d7ae34afff850dd4fc09c94527d50513 - Sigstore transparency entry: 2757303726
- Sigstore integration time:
-
Permalink:
blazingagents/python-sdk@5fe4d458800667414245c27cd1802566b756b3f0 -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/blazingagents
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@5fe4d458800667414245c27cd1802566b756b3f0 -
Trigger Event:
release
-
Statement type:
