pip install lunar

export LUNAR_API_KEY="your-api-key"

from lunar import Lunar

client = Lunar()  # Uses LUNAR_API_KEY from environment

client = Lunar(api_key="your-api-key")

client = Lunar(
    api_key="your-api-key",
    timeout=60.0,                 # Request timeout in seconds
    num_retries=2,                # Retry attempts for failed requests
    max_connections=100,          # Max concurrent connections
    fallbacks={                   # Global fallback configuration
        "gpt-4o-mini": ["claude-3-haiku", "llama-3.1-8b"],
        "gpt-4": ["claude-3-opus"]
    }
)

from lunar import Lunar

with Lunar(api_key="your-api-key") as client:
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": "Hello!"}]
    )
# Resources automatically cleaned up

from lunar import AsyncLunar

async with AsyncLunar(api_key="your-api-key") as client:
    response = await client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": "Hello!"}]
    )
# Resources automatically cleaned up

from lunar import Lunar

try:
    client = Lunar()
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": "Say 'Hello from Lunar!'"}],
        max_tokens=20
    )
    print("Success:", response.choices[0].message.content)
    print(f"Cost: ${response.usage.total_cost_usd}")
except Exception as e:
    print(f"Error: {e}")