configuration

Documentation Index

Fetch the complete documentation index at: https://docs.galileo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

ConfigKey

• name (str): The attribute name used in the Configuration class (e.g., “galileo_api_key”).
• env_var (str): The corresponding environment variable name (e.g., “GALILEO_API_KEY”).
• description (str): Human-readable description of the configuration key’s purpose.
• required (bool): Whether this key must be set for the configuration to be considered complete. Default: False.
• sensitive (bool): Whether this key contains sensitive information (e.g., API keys, passwords). Sensitive values are masked in get_configuration() output. Default: False.
• default (Any): The default value if no explicit value or environment variable is set. Default: None.
• value_type (type): The expected Python type for this configuration value. Default: str.
• parser (Optional[Callable[[str], Any]]): Optional function to convert string values from environment variables to the appropriate type. Default: None (no conversion).

​

ConfigurationMeta

1. Checks if the attribute is in _CONFIGURATION_KEYS
2. Resolves the value from: explicit value → environment variable → .env file → default
3. Applies type conversion and validation if a parser is defined
4. Returns the resolved value

1. Stores the value internally (with underscore prefix: _galileo_api_key)
2. Automatically updates the corresponding environment variable
3. Ensures compatibility with libraries that read from os.environ

• Extensibility: New configuration keys can be added to _CONFIGURATION_KEYS
• Consistency: All configuration uses the same resolution pattern
• Compatibility: Environment variables are kept in sync for third-party libraries
• Transparency: Configuration sources are clearly prioritized

​

Configuration

1. Explicitly set value (via Configuration.key = value)
2. Environment variable (e.g., GALILEO_API_KEY)
3. .env file (loaded automatically on first access)
4. Default value (defined in the key configuration)

• Syncs attribute assignments to environment variables
• Loads .env files on first configuration access
• Provides type conversion and validation via parsers

• Configuration attributes are dynamically provided based on _CONFIGURATION_KEYS: galileo_api_key (str): API key for Galileo authentication (sensitive) console_url (str): URL of the Galileo console openai_api_key (str): OpenAI API key for SDK interoperability (sensitive) default_project_name (str): Default project name default_project_id (str): Default project ID default_logstream_name (str): Default log stream name default_logstream_id (str): Default log stream ID logging_disabled (bool): Disable all telemetry logging to Galileo log_level (str): Python logging level for SDK console output

# Access via class attribute (reads from env vars, .env, or defaults)
api_key = Configuration.galileo_api_key
url = Configuration.console_url

# Set explicitly (also updates environment variables)
Configuration.galileo_api_key = "your-api-key"
Configuration.console_url = "https://console.galileo.ai"

# Check if required configuration is present
if Configuration.is_configured():
    Configuration.connect()

# Get all configuration values (sensitive values are masked)
config = Configuration.get_configuration()
print(config["galileo_api_key"])  # Output: "***"
print(config["console_url"])       # Output: actual URL

# Clear all configuration values and environment variables
Configuration.reset()

# Enable console logging for debugging
Configuration.enable_console_logging()  # INFO level by default
Configuration.enable_console_logging("DEBUG")  # Verbose output

# Disable console logging
Configuration.disable_console_logging()

• The Configuration class should not be instantiated; use it as a static class
• Direct attribute access (e.g., Configuration.galileo_api_key) is the recommended pattern
• The get_configuration() method masks sensitive values for safe display/logging
• Setting an attribute automatically updates the corresponding environment variable
• This design maintains compatibility with third-party libraries expecting env vars

​

connect

def connect(cls) -> None

​

disable_console_logging

def disable_console_logging(cls) -> None

Configuration.disable_console_logging()

​

enable_console_logging

def enable_console_logging(cls, level: str | None=None) -> None

• level (Optional[str]): Logging level as string: “DEBUG”, “INFO”, “WARNING”, “ERROR”, “CRITICAL”. If not provided, uses Configuration.log_level or defaults to “INFO”.

# Enable with default INFO level
Configuration.enable_console_logging()

# Enable with DEBUG level for verbose output
Configuration.enable_console_logging("DEBUG")

# Or set via configuration and enable
Configuration.log_level = "DEBUG"
Configuration.enable_console_logging()

​

get_configuration

def get_configuration(cls) -> dict[str, Any]

​

is_configured

def is_configured(cls) -> bool

​

reset

def reset(cls) -> None

​

parse_log_level

def parse_log_level(value: str) -> str