lumen-ai-core 0.1.3

LumenAI Core — Real-time FinOps & Observability layer for Generative AI

lumen-ai-core

Core package for the LumenAI SDK.

Includes

• LumenAI.init() and LumenAI.shutdown()
• Tenant context helpers: set_tenant_id, get_tenant_id, clear_tenant_id, lumen_tenant
• OTel processors for tenant tagging, cost computation, and event normalization
• RedisExporter, AsyncRedisExporter, and JsonlExporter
• LumenAIEvent typed event contract
• SQLAlchemy ORM models for downstream storage integrations

Install

pip install lumen-ai-core

Minimal Example

from lumen_ai import LumenAI, lumen_tenant

LumenAI.init(redis_url="redis://localhost:6379/0")

with lumen_tenant("client-acme"):
    # Create OTel GenAI spans here.
    pass

LumenAI.shutdown()

For a no-service local sink:

from lumen_ai import JsonlExporter, LumenAI

LumenAI.init(exporter=JsonlExporter("lumen-events.jsonl"))

See the repository README for the full demo and development gates.