Lenzy AI Python SDK

Official Python SDK for the Lenzy AI analytics platform.

Installation

pip install lenzyai

Quick Start

from lenzyai import Lenzy

# Initialize the client
client = Lenzy(api_key="your-api-key")

# Record messages
client.record_messages(
    project_id="proj_123",
    external_conversation_id="conv_456",
    messages=[
        {
            "role": "USER",
            "content": "Hello!",
            "external_id": "msg_1",  # optional
            "sent_at": "2025-11-27T10:30:00.000Z",  # optional
        },
        {"role": "ASSISTANT", "content": "Hi there! How can I help you?"},
    ],
    external_user_id="user_789",  # optional
)

Configuration

The SDK can be configured in three ways (in order of precedence):

1. Constructor Parameters

from lenzyai import Lenzy

client = Lenzy(
    api_key="your-api-key",
    enabled=True,  # Optional, defaults to True
)

2. Environment Variables

export LENZY_API_KEY="your-api-key"
export LENZY_ENABLED="true"  # Optional, set to "false" or "0" to disable

from lenzyai import Lenzy

# Will use environment variables
client = Lenzy()

3. Defaults

• enabled: True

Disabling the SDK

You can disable the SDK in non-production environment without removing code:

# Method 1: Constructor
client = Lenzy(api_key="your-api-key", enabled=False)

# Method 2: Environment variable
# export LENZY_ENABLED="false"
client = Lenzy(api_key="your-api-key")

# All record_messages() calls will be no-ops
client.record_messages(...)  # Does nothing

Error Handling

The SDK uses a fail-safe design:

• Errors during initialization raise exceptions
• Errors during record_messages() are logged but never raise exceptions
• All errors are logged with the prefix "Lenzy Error:"

import logging

# Configure logging to see errors
logging.basicConfig(level=logging.ERROR)

client = Lenzy(api_key="your-api-key")
client.record_messages(...)  # Logs errors, never crashes

Requirements

• Python 3.8+
• requests>=2.25.0
• typing-extensions>=4.0.0

License

MIT License - see LICENSE file for details.