Python

# Install with OpenAI support
pip install ambertrace[openai]

# Install with Anthropic support
pip install ambertrace[anthropic]

# Install with Google support (original SDK)
pip install ambertrace[gemini]

# Install with Google support (newer SDK)
pip install ambertrace[gemini-new]

# Install with all providers
pip install ambertrace[all]

# Or install core and add SDKs separately
pip install ambertrace
pip install openai anthropic google-generativeai

pip install ambertrace
pip install openai anthropic google-generativeai

import openai
import ambertrace

# 1. Initialize AmberTrace (once at startup)
ambertrace.init(api_key="your_ambertrace_api_key")

# 2. Use OpenAI as normal — tracing happens automatically
client = openai.OpenAI(api_key="your_openai_api_key")
response = client.chat.completions.create(
    model="gpt-4",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)
print(response.choices[0].message.content)

# 3. Flush traces before exit
ambertrace.flush()

import anthropic
import ambertrace

# 1. Initialize AmberTrace (do this once at startup)
ambertrace.init(api_key="your_ambertrace_api_key")

# 2. Use Anthropic SDK normally - tracing happens automatically!
client = anthropic.Anthropic(api_key="your_anthropic_api_key")
response = client.messages.create(
    model="claude-opus-4-5-20251101",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)
print(response.content[0].text)

# 3. (Optional) Flush traces before exit
ambertrace.flush()

import google.generativeai as genai
import ambertrace

# 1. Initialize AmberTrace (do this once at startup)
ambertrace.init(api_key="your_ambertrace_api_key")

# 2. Use Google SDK normally - tracing happens automatically!
genai.configure(api_key="your_gemini_api_key")
model = genai.GenerativeModel("gemini-pro")
response = model.generate_content("Hello!")
print(response.text)

# 3. (Optional) Flush traces before exit
ambertrace.flush()

from google import genai
import ambertrace

ambertrace.init(api_key="your_ambertrace_api_key")

client = genai.Client(api_key="your_gemini_api_key")
response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="Hello!"
)

print(response.text)
ambertrace.flush()

import openai
import anthropic
import google.generativeai as genai
import ambertrace

# Initialize once - traces all providers automatically
ambertrace.init(api_key="your_ambertrace_api_key")

# Use OpenAI
openai_client = openai.OpenAI(api_key="your_openai_api_key")
gpt_response = openai_client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "What is Python?"}]
)

# Use Anthropic
anthropic_client = anthropic.Anthropic(api_key="your_anthropic_api_key")
claude_response = anthropic_client.messages.create(
    model="claude-opus-4-5-20251101",
    max_tokens=1024,
    messages=[{"role": "user", "content": "What is Python?"}]
)

# Use Google
genai.configure(api_key="your_gemini_api_key")
gemini_model = genai.GenerativeModel("gemini-pro")
gemini_response = gemini_model.generate_content("What is Python?")

# All calls are traced to AmberTrace!
ambertrace.flush()

import openai
import ambertrace

ambertrace.init(api_key="your_api_key")

client = openai.OpenAI(api_key="invalid_key")

try:
    response = client.chat.completions.create(
        model="gpt-4",
        messages=[{"role": "user", "content": "Hello!"}]
    )
except openai.AuthenticationError as e:
    # OpenAI error is raised normally to your code
    # BUT the error is also traced and sent to AmberTrace
    print(f"Authentication failed: {e}")

import ambertrace

ambertrace.init(api_key="your_api_key")

# Temporarily disable tracing
ambertrace.disable()

# ... OpenAI calls here are NOT traced ...

# Re-enable tracing
ambertrace.enable()

# ... OpenAI calls here ARE traced again ...

import ambertrace

if ambertrace.is_enabled():
    print("Tracing is active")
else:
    print("Tracing is disabled")