Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bentolabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Environment variables

VariableDefaultNotes
BENTOLABS_API_KEY(required)From platform.bentolabs.ai. Format bl_pk_... (validated up front).
BENTOLABS_BASE_URLhttps://api.bentolabs.aiOverride only for self-hosted or local dev. Must be http:// or https://.

​
In-code config

init() kwargs override env vars: 
import bentolabs_sdk.analytics as bento

bento.init(api_key="bl_pk_explicit", base_url="http://localhost:8080")
init() is optional. The first track_ai call will lazy-initialize from env vars automatically. Call init() explicitly when you want to pay setup cost up front (cold-start sensitive workloads) or pass credentials from code.

​
Lifecycle

WhenWhat to call
Long-running serviceNothing. Lazy init on the first track_ai works.
Serverless or cold-start sensitiveCall bento.init() at module load to pay the setup cost up front instead of on a user request.
Short-lived script or LambdaCall bento.flush() before exit. Spans batch by default; without flushing, the last few calls may not ship.
Rotating credentialsbento.shutdown() then bento.init(api_key="bl_pk_new...").
Calling init() twice with conflicting credentials raises BentoAuthError("already_initialized"). Call shutdown() first to rotate.

​
Errors

The SDK raises BentoAuthError with a typed code for fail-fast cases: 
from bentolabs_sdk import BentoAuthError

try:
    bento.init()
except BentoAuthError as exc:
    if exc.code == "missing_api_key":
        # telemetry disabled or misconfigured
        pass
    elif exc.code == "invalid_api_key_format":
        # key doesn't start with bl_pk_
        pass
    elif exc.code == "already_initialized":
        # conflicting credentials, call shutdown() first
        pass
    raise
CodeWhen
missing_api_keyNo key passed and BENTOLABS_API_KEY not set.
invalid_api_key_formatKey does not start with bl_pk_.
already_initializedinit() called twice with conflicting api_key or base_url.

​
Resolution helpers

For tools that need to know the resolved config without standing up a tracer: 
from bentolabs_sdk import resolve_options

cfg = resolve_options()
print(cfg.api_key, cfg.base_url)
Returns a frozen BentoConfig(api_key, base_url) dataclass. Same resolution order as init().