Metadata-Version: 2.4
Name: codexray-sdk
Version: 0.1.0
Summary: CodeXRay telemetry SDK — watch your software think
Author: CodeXRay authors
License: UNLICENSED
Project-URL: Homepage, https://github.com/Gugilla-Aakash/codeXray
Project-URL: Repository, https://github.com/Gugilla-Aakash/codeXray
Project-URL: Issues, https://github.com/Gugilla-Aakash/codeXray/issues
Keywords: telemetry,observability,tracing,codexray,opentelemetry-alternative
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# codexray-sdk

Watch your software think. Zero-dependency Python telemetry for CodeXRay.

```bash
pip install codexray-sdk
cd your-project
codexray init                        # creates the CodeXRay project
codexray serve --app app.main:app    # serve with live tracing
# → open the printed dashboard link
```

Local development (from this repo):

```bash
pip install -e /path/to/sdk/python
```

Manual spans for deeper causality (DB calls, LLM calls, jobs):

```python
from codexray import Tracer

tracer = Tracer(service="my-api", api_url="http://127.0.0.1:3101", api_key="cxr_...")

with tracer.span("groq chat", service="groq", metadata={"model": "llama-3.1-8b-instant"}):
    answer = chat(...)
```

`codexray doctor` checks API reachability + auth. Telemetry failures never
raise into your app.
