Metadata-Version: 2.4
Name: lumen-ai-core
Version: 0.1.3
Summary: LumenAI Core — Real-time FinOps & Observability layer for Generative AI
Project-URL: Homepage, https://github.com/skarL007/-lumen-ai-sdk
Project-URL: Repository, https://github.com/skarL007/-lumen-ai-sdk
Project-URL: Bug Tracker, https://github.com/skarL007/-lumen-ai-sdk/issues
Project-URL: Funding, https://github.com/sponsors/skarL007
Author-email: skarL007 <zpka21@hotmail.com>
License: MIT
Keywords: ai,cost-tracking,finops,llm,multi-tenancy,observability,opentelemetry
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.11
Requires-Dist: opentelemetry-api>=1.30.0
Requires-Dist: opentelemetry-instrumentation>=0.40b0
Requires-Dist: opentelemetry-sdk>=1.30.0
Requires-Dist: redis>=5.0.0
Requires-Dist: sqlalchemy>=2.0.0
Description-Content-Type: text/markdown

# 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

```bash
pip install lumen-ai-core
```

## Minimal Example

```python
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:

```python
from lumen_ai import JsonlExporter, LumenAI

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

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