Skip to main content

​
Synchronous Initialization

The agent_secret is required and must be passed directly: 
from value import initialize_sync

client = initialize_sync(agent_secret="your_agent_secret")
With custom service name: 
client = initialize_sync(
    agent_secret="your_agent_secret",
    service_name="my-agent"
)

​
Asynchronous Initialization

import asyncio
from value import initialize_async

async def main():
    client = await initialize_async(agent_secret="your_agent_secret")
    # Use client...

asyncio.run(main())

​
Environment Variables

Additional configuration can be set using environment variables:
VariableDescriptionRequired
VALUE_BACKEND_URLValue Control Plane URLYes
VALUE_OTEL_ENDPOINTOpenTelemetry collector endpointNo (default: http://localhost:4317)
VALUE_CONSOLE_EXPORTEnable console span export for debuggingNo (default: false)

​
Manual Initialization

For more control, instantiate the client directly: 
from value import ValueClient

client = ValueClient(
    secret="your_agent_secret",  # Required
    service_name="my-agent",
    backend_url="https://value.valmi.io",  # Or use VALUE_BACKEND_URL env var
    otel_endpoint="http://value.valmi.io",  # Optional
    enable_console_export=False,  # Optional: for debugging
)
client.initialize()

​
Client Properties

After initialization, the client provides:
  • client.agent_id - Agent instance ID
  • client.agent_name - Agent instance name
  • client.workspace_id - Workspace ID
  • client.organization_id - Organization ID
  • client.tracer - OpenTelemetry tracer instance