Metadata-Version: 2.4
Name: cecil-sdk
Version: 0.1.0
Summary: Lightweight LLM observability SDK with privacy-first defaults
Author: Cecil SDK Team
License-Expression: MIT
Project-URL: Homepage, https://github.com/cecil-sdk/cecil-python
Project-URL: Repository, https://github.com/cecil-sdk/cecil-python
Project-URL: Issues, https://github.com/cecil-sdk/cecil-python/issues
Project-URL: Documentation, https://github.com/cecil-sdk/cecil-python/tree/main/docs
Keywords: llm,observability,telemetry,openai,anthropic
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: jsonschema>=4.22.0
Provides-Extra: dev
Requires-Dist: black>=24.8.0; extra == "dev"
Requires-Dist: mypy>=1.11.2; extra == "dev"
Requires-Dist: pytest>=8.3.2; extra == "dev"
Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
Requires-Dist: ruff>=0.6.4; extra == "dev"
Requires-Dist: twine>=6.2.0; extra == "dev"
Provides-Extra: live-openai
Requires-Dist: openai==1.40.0; extra == "live-openai"
Requires-Dist: httpx==0.27.2; extra == "live-openai"
Dynamic: license-file

# Cecil Python SDK

`cecil-sdk` is a privacy-first Python SDK for LLM cost visibility and cache optimization insights.

## Install

```bash
pip install cecil-sdk
```

## Quickstart

```python
import cecil

cecil.patch()
```

Default behavior is local-only. No telemetry is sent unless explicitly enabled.

## Why Cecil

- Privacy-first defaults (hashed metadata, no raw prompt export by default)
- Fail-open instrumentation (SDK failures do not break provider calls)
- Actionable cost and cache opportunity analytics
- Lightweight integration (`import cecil; cecil.patch()`)

## Development

```bash
pip install -e ".[dev]"
make lint
make typecheck
make test
make build
python -m twine check dist/*
python scripts/smoke_check_wheel.py
```

## Documentation

- `docs/quickstart.md`
- `docs/telemetry-opt-in.md`
- `docs/privacy-contract.md`
- `docs/recommendations.md`
- `docs/release-checklist.md`

## License

MIT. See `LICENSE`.
