Overview
When using a self-hosted xpander.ai deployment, you need to configure the SDK to point to your Agent Controller endpoint instead of the default xpander.ai cloud service.Configuration Methods
Environment Variables (Recommended)
Set theXPANDER_BASE_URL environment variable to your Agent Controller endpoint:
Explicit Configuration
Pass thebase_url parameter directly when creating the Configuration object:
Using .env Files
Create a.env file in your project root:
.env
Usage Examples
Basic SDK Usage
Using with Agno Framework
Important Notes
Endpoint URL: Make sure your
base_url points to the Agent Controller endpoint (e.g., https://agent-controller.{your-domain}), not the root domain or other services.Related Documentation
- Self-Hosted Deployment Guide - Complete guide for deploying xpander.ai on your infrastructure
- [Configuration Module](/API reference/configuration) - Full Configuration class reference
- [Agents Module](/API reference/agents) - Working with agents
- [Tasks Module](/API reference/tasks) - Task management and execution

