xpander_utils Package Development Guide
Overview
xpander_utils is a Python utilities SDK for xpander.ai services.
It provides adapters, helpers, and utilities to integrate and enhance the development of AI agents, workflows, and more.
- Package Name:
xpander_utils - Version:
0.0.1 - Author: xpanderAI
- Email: dev@xpander.ai
- License: MIT License
- URL: https://www.xpander.ai
Installation
Install from PyPI
To use the xpander_utils package in your project, install it via pip:
pip install xpander-utils
Install Locally (Development Mode)
If you want to contribute or modify the package, clone the repository and install it locally in editable mode:
pip install -e .
This allows you to make changes to the source code without reinstalling the package after each modification.
Usage Example
Here's a simple example using SmolAgentsAdapter to bridge between xpander.ai and smolagents:
from smolagents import OpenAIServerModel, ToolCallingAgent
from xpander_utils.sdk.adapters import SmolAgentsAdapter
# API keys
llm_api_key = "{YOUR_LLM_KEY}"
xpander_api_key = "{YOUR_API_KEY}"
# Initialize Xpander agent
xpander = SmolAgentsAdapter(agent_id="{YOUR_AGENT_ID}", api_key=xpander_api_key)
# Initialize model
model = OpenAIServerModel(
model_id="gpt-4o",
api_key=llm_api_key
)
# Add a task to Xpander
prompt = "get the longest tag"
xpander.add_task(input=prompt)
# Build the agent using Xpander's tools
agent = ToolCallingAgent(
step_callbacks=[xpander.step_callback()],
tools=xpander.get_tools(),
model=model,
prompt_templates={"system_prompt": xpander.get_system_prompt()}
)
# Initialize memory from Xpander
xpander.init_memory(agent=agent)
# Run the agent
result = agent.run(task=prompt, reset=False)
Dependencies
The package requires the following libraries:
pydanticloguruxpander-sdkhttpxhttpx_sse
Optional / Extras
Additional functionality can be installed with extras:
| Extra | Libraries Installed |
|---|---|
smolagents |
smolagents |
llama-index |
llama_index |
chainlit |
chainlit |
agno |
agno |
Example to install with extras:
pip install "xpander-utils[smolagents]"
You can combine extras:
pip install "xpander-utils[smolagents,llama-index,agno]"
AgnoAdapter Example
Here's an example using AgnoAdapter to integrate xpander.ai with agno:
import asyncio
from agno.agent import Agent
from agno.models.openai import OpenAIChat
from xpander_utils.sdk.adapters import AgnoAdapter
async def main():
# Initialize AgnoAdapter
adapter = AgnoAdapter(
agent_id="{YOUR_AGENT_ID}",
api_key="{YOUR_XPANDER_API_KEY}"
)
# Add task to xpander
adapter.add_task(input="Send a welcome email")
# Get tools and create agno agent
tools = adapter.get_tools()
agent = Agent(
model=OpenAIChat(id="gpt-4o-mini", api_key="{YOUR_OPENAI_API_KEY}"),
tools=tools,
instructions=adapter.get_system_prompt(),
add_history_to_messages=True,
markdown=True
)
# Run the agent
response = await agent.arun("Send an email with subject 'Hello' to user@example.com")
print(response.content)
# Run the async function
asyncio.run(main())
Supported Python Versions
This package officially supports Python >= 3.12.7.
Ensure you are using a compatible Python version for full functionality.
License
This project is licensed under the MIT License.
Development Notes
- Source code is located under the
src/directory. - Package discovery is handled via
find_packages(where="src"). long_descriptionfor the package is directly pulled fromREADME.md.
1 maintainer
Metadata
1 maintainer
Release files for xpander-utils 0.0.126
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| xpander_utils-0.0.126.tar.gz | 27.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| xpander_utils-0.0.126-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 59.3 kB
Release files / xpander_utils-0.0.126.tar.gz
| Download URL | xpander_utils-0.0.126.tar.gz |
|---|---|
| Size | 27.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7e57b5bc04f620433fcc0875a7d1071e7c0958865d2b7d174f9a1165941cba7c
|
|
BLAKE2b-256 checksum How to use checksums |
931ccd808aa0c793a1b2247ec7240df192fded10eca0a25dfcff723af10aeb25
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.11
|
Release files / xpander_utils-0.0.126-py3-none-any.whl
| Download URL | xpander_utils-0.0.126-py3-none-any.whl |
|---|---|
| Size | 32.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2a218836680018972f6f479c2d78bb2ef2b80b7d83e7fa49a579fae077784a58
|
|
BLAKE2b-256 checksum How to use checksums |
86875f938f5c21f5dd27815d912b3bd322069e73f950f07f97977db52a384c20
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.11
|
