lenzyai 0.0.4

Python SDK for Lenzy AI analytics platform

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.