Skip to main content

​
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 Google Vertex AI integration. Examples 
vertex = Integration.vertex_ai
if vertex:
    print(f"Vertex AI integration: {vertex.id}")