xpander-sdk

What it is and what it does

xpander-sdk is the official Python client for xpander.ai, a Backend-as-a-Service platform for AI agents. It provides a unified interface to create, configure, deploy, and monitor AI agents at scale, handling the full lifecycle from agent initialization through task execution and result retrieval. The SDK abstracts away infrastructure management, allowing developers to focus on agent logic and workflows.

The package includes modules for agent management, task lifecycle control, tool registration and invocation, knowledge base operations, and event-driven programming via decorators. It integrates with OpenAI agents, Strands agents, and Headroom AI, and includes built-in support for document processing (PDF, Word, Excel, PowerPoint, images). A progressive context optimization pipeline manages token usage across agent conversations, automatically compacting context when approaching model limits and persisting summaries for retry continuity.

Use it for:

• Build and deploy multi-agent systems that coordinate complex workflows across document analysis, data processing, and external tool integration.
• Create event-driven agent handlers that respond to task lifecycle events using decorator-based programming patterns.
• Manage knowledge repositories and enable agents to search and retrieve information from uploaded documents and external sources.
• Integrate external tools and services into agent workflows via the tools repository and custom tool registration.
• Monitor and track agent performance, execution status, and task activity logs in real-time through the SDK's monitoring interface.

Worth the install?

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

Python SDK for building, deploying, and managing AI agents on the xpander.ai Backend-as-a-Service platform, with support for agent lifecycle management, task execution, tool integration, knowledge bases, and event-driven workflows.

Yes, with conditions. The SDK is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive MIT license. Install if you are building on the xpander.ai platform and need Python-native agent management. The 18 runtime dependencies are substantial; verify that optional dependencies can be excluded if you only need core agent operations. Not suitable if you need a standalone agent framework independent of xpander.ai infrastructure.

Install

xpander-sdk on PyPI

pip install xpander-sdk

uv add xpander-sdk

poetry add xpander-sdk

Installing xpander-sdk

Before you install

Low install friction with a pure-Python wheel distribution. Active maintenance status with a release 1 day old. Requires Python 3.10 or later. Brings 18 runtime dependencies including FastAPI, Pydantic, OpenAI agents, and document processing libraries (python-docx, openpyxl, python-pptx, pypdf).

License in practice

MIT license (permissive) allows commercial and private use with minimal restrictions, making it suitable for production deployment in most contexts.

Quickstart

pip install xpander-sdk

from xpander_sdk import Configuration, Agents

config = Configuration(api_key="your-api-key", organization_id="your-org-id")
agents = Agents(configuration=config)
agent_list = await agents.alist()

Requires Python 3.10 or later; xpander.ai API credentials (api_key and organization_id) needed for runtime operations.

Verify before relying

• Whether the 18 runtime dependencies are all required for basic usage or if many are optional for specific features.
• Performance characteristics and scalability limits for concurrent agent management.
• Detailed error handling and retry behavior for API calls and task execution.
• Whether context optimization layers (Toon Encoding, Microcompaction, Auto-Compaction) are automatic or require explicit configuration.

Package facts

Evidence: xpander_sdk-2.0.456-py3-none-any.whl

Tags

More Artificial Intelligence packages