integration

Factory interface for managing Galileo integrations. Integration is the main entry point for working with LLM providers and other external services in the Galileo platform. It provides factory methods to create new integrations and list existing ones. The Integration class returns Provider objects, which are immutable proxies to integrations stored in the Galileo API. Provider classes should not be imported or instantiated directly - always use the Integration class methods. Examples

# List all available integration types (including unconnected)
available_types = Integration.list(all=True)
# Returns: ['anthropic', 'aws_bedrock', 'azure', 'openai', ...]

# Create a new OpenAI integration
openai = Integration.create_openai(
    token="sk-proj-...",
    organization_id="org-..."
)
print(f"Created: {openai.id}")

# Create an Azure integration
azure = Integration.create_azure(
    token="your-key",
    endpoint="https://your-resource.openai.azure.com"
)

# List all connected integrations (returns provider proxy objects)
providers = Integration.list()
for provider in providers:
    print(f"{provider.name}: {provider.id}")
    print(f"Created by: {provider.created_by}")
    print(f"Selected: {provider.is_selected}")

# Update provider credentials
openai.update(
    token="new-sk-proj-...",
    organization_id="new-org-..."
)

# Refresh provider state from API
openai.refresh()

# Get available models (placeholder - not yet implemented)
# models = openai.models

# Delete a provider
openai.delete()

# Create other providers
bedrock = Integration.create_bedrock(
    aws_access_key_id="AKIA...",
    aws_secret_access_key="...",
    region="us-west-2"
)

anthropic = Integration.create_anthropic(token="sk-ant-...")

anthropic

def anthropic(cls) -> Provider | UnconfiguredProvider

Get the configured Anthropic (Claude) integration. Examples

anthropic = Integration.anthropic
if anthropic:
    print(f"Anthropic integration: {anthropic.id}")

azure

def azure(cls) -> Provider | UnconfiguredProvider

Get the configured Azure OpenAI integration. Examples

azure = Integration.azure
if azure:
    print(f"Azure integration: {azure.id}")

bedrock

def bedrock(cls) -> Provider | UnconfiguredProvider

Get the configured AWS Bedrock integration. Examples

bedrock = Integration.bedrock
if bedrock:
    print(f"Bedrock integration: {bedrock.id}")

create_anthropic

def create_anthropic(cls, *, token: str) -> AnthropicProvider

Create a new Anthropic (Claude) integration. Arguments

token (str): Anthropic API token.

create_azure

def create_azure(cls, *, token: str, endpoint: str) -> AzureProvider

Create a new Azure OpenAI integration. Arguments

token (str): Azure API key.
endpoint (str): Azure OpenAI endpoint URL.

create_bedrock

def create_bedrock(cls,
                   *,
                   aws_access_key_id: str,
                   aws_secret_access_key: str,
                   region: str='us-east-1',
                   credential_type: str='key_secret') -> BedrockProvider

Create a new AWS Bedrock integration. Arguments

aws_access_key_id (str): AWS access key ID.
aws_secret_access_key (str): AWS secret access key.
region (str): AWS region. Defaults to “us-east-1”.
credential_type (str): Type of credentials. Defaults to “key_secret”.

create_openai

def create_openai(cls,
                  *,
                  token: str,
                  organization_id: str | None=None) -> OpenAIProvider

Create a new OpenAI integration. Arguments

token (str): OpenAI API token.
organization_id (str | None): Optional organization ID.

list

def list(cls, *, all: bool=False) -> list[Provider] | list[str]

List integrations. Arguments

all (bool): If True, returns all available integration types (including unconnected ones) as a list of strings. If False, returns only the configured integrations as Provider objects. Defaults to False.

mistral

def mistral(cls) -> Provider | UnconfiguredProvider

Get the configured Mistral AI integration. Examples

mistral = Integration.mistral
if mistral:
    print(f"Mistral integration: {mistral.id}")

openai

def openai(cls) -> Provider | UnconfiguredProvider

Get the configured OpenAI integration. Examples

openai = Integration.openai
if openai:
    print(f"OpenAI integration: {openai.id}")

refresh

def refresh(self) -> None

Refresh the integration state from the remote API. Note: Currently, the API does not support fetching individual integrations by ID. This method will re-fetch all integrations and find the matching one.

Raises

APIError: If the API call fails or the integration is not found.

vertex_ai

def vertex_ai(cls) -> Provider | UnconfiguredProvider

Get the configured Gemini Enterprise integration (provider id vertex_ai; previously Vertex AI). Examples

vertex = Integration.vertex_ai
if vertex:
    print(f"Gemini Enterprise integration: {vertex.id}")

​Integration

​anthropic

​azure

​bedrock

​create_anthropic

​create_azure

​create_bedrock

​create_openai

​list

​mistral

​openai

​refresh

​Raises

​vertex_ai

Integration