Python SDK Configuration

​

Overview

• None or no arguments - reads from environment variables
• str - API key string (backward compatible)
• EdgeeConfig - Configuration dataclass (type-safe)
• dict - Plain dictionary (flexible)

​

Method 1: Environment Variables (Recommended for Production)

from edgee import Edgee

# Reads from EDGEE_API_KEY and EDGEE_BASE_URL environment variables
edgee = Edgee()

​

Method 2: String API Key (Quick Start)

from edgee import Edgee

# API key only (uses default base URL: https://edgee.io)
edgee = Edgee("your-api-key")

​

Method 3: Configuration Object (Type-Safe)

from edgee import Edgee, EdgeeConfig

# Full configuration
edgee = Edgee(EdgeeConfig(
    api_key="your-api-key",
    base_url="https://edgee.io"  # optional, defaults to https://edgee.io
))

​

Configuration Priority

1. Constructor argument (if provided)
2. Environment variable (if constructor argument is missing)
3. Default value (for base_url only, defaults to https://edgee.io)

​

Complete Examples

# .env file
# EDGEE_API_KEY=prod-api-key
# EDGEE_BASE_URL=https://edgee.io

from dotenv import load_dotenv
from edgee import Edgee

load_dotenv()
edgee = Edgee()  # Reads from environment

import os
from edgee import Edgee, EdgeeConfig

ENV = os.getenv("ENVIRONMENT", "development")

if ENV == "production":
    edgee = Edgee()  # Use environment variables
elif ENV == "staging":
    edgee = Edgee(EdgeeConfig(
        api_key=os.getenv("EDGEE_API_KEY")
    ))
else:
    edgee = Edgee(EdgeeConfig(
        api_key="dev-api-key",
        base_url="https://eu.edgee.io"
    ))

​

Troubleshooting

​

”EDGEE_API_KEY is not set” Error

1. Set the environment variable:
   export EDGEE_API_KEY="your-api-key"
   
2. Pass it directly:
   edgee = Edgee("your-api-key")
   
3. Use EdgeeConfig:
   edgee = Edgee(EdgeeConfig(api_key="your-api-key"))
   

​

Custom Base URL Not Working

1. Verify the base URL in your configuration
2. Check whether an explicit constructor URL takes precedence over EDGEE_BASE_URL
3. Ensure you’re using the correct configuration method

# This will use the base_url from EdgeeConfig
edgee = Edgee(EdgeeConfig(
    api_key="key",
    base_url="https://custom.example.com"
))

# This will use EDGEE_BASE_URL env var if set, otherwise default
edgee = Edgee("key")