Installation

Requirements

• Python 3.10 or higher
• A supported model provider (AWS credentials for Bedrock, or an API key for others)

Install the SDK and Models Package

To build agents, you will need the elsai-agents package along with the elsai-model package, which provides a unified set of standalone model connectors:

pip install --extra-index-url https://elsai-agents.elsai.ai/root/ elsai-agents==0.1.0

To include pre-built sample tools as well:

pip install --extra-index-url https://elsai-agents.elsai.ai/root/ elsai-agents==0.1.0 elsai-agents-tools

Supported Model Connectors

The standalone elsai-model package comes pre-packaged with all required dependencies for:

• OpenAI (OpenAIConnector)
• Azure OpenAI (AzureOpenAIConnector)
• Google Gemini (GeminiService)
• Amazon Bedrock (BedrockConnector)
• LiteLLM (LiteLLMConnector)
• Anthropic Bedrock (AnthropicBedrockConnector)

Optional extras

Install additional system protocols or telemetry extensions:

# OpenTelemetry exporter (OTLP)
pip install --extra-index-url https://elsai-agents.elsai.ai/root/ "elsai-agents[otel]==0.1.0"

# Agent-to-Agent protocol (A2A)
pip install --extra-index-url https://elsai-agents.elsai.ai/root/ "elsai-agents[a2a]==0.1.0"

# Everything (including A2A and OTEL)
pip install --extra-index-url https://elsai-agents.elsai.ai/root/ "elsai-agents[all]==0.1.0"

Bidirectional streaming (experimental)

# Server-side only (no audio I/O)
pip install --extra-index-url https://elsai-agents.elsai.ai/root/ "elsai-agents[bidi]==0.1.0"

# With local audio capture/playback (requires PyAudio)
pip install --extra-index-url https://elsai-agents.elsai.ai/root/ "elsai-agents[bidi,bidi-io]==0.1.0"

Virtual environment (recommended)

python -m venv .venv
source .venv/bin/activate      # Windows: .venv\Scripts\activate
pip install --extra-index-url https://elsai-agents.elsai.ai/root/ elsai-agents==0.1.0 elsai-agents-tools

Verify installation

import elsai
print(elsai.__version__)

Configure your model provider

By default the SDK uses Amazon Bedrock with the Claude 3 Sonnet model in us-west-2. Make sure you have AWS credentials configured:

aws configure
# or set environment variables
export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...
export AWS_DEFAULT_REGION=us-west-2

For other providers, see the Model Providers section.