Metadata-Version: 2.4
Name: radicas
Version: 0.1.1
Summary: Radicas Python SDK — connect any agent framework to Radicas, correct-by-construction
Project-URL: Repository, https://github.com/radicas-ai/radicas-integrations
Project-URL: Documentation, https://github.com/radicas-ai/radicas-integrations/tree/main/docs/sdk
Author: Radicas
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agents,cost,gen_ai,observability,opentelemetry,radicas
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
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.27
Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.27
Requires-Dist: opentelemetry-sdk>=1.27
Provides-Extra: adk
Requires-Dist: google-adk>=1.17; extra == 'adk'
Provides-Extra: all
Requires-Dist: google-adk>=1.17; extra == 'all'
Requires-Dist: litellm>=1.48; extra == 'all'
Requires-Dist: openinference-instrumentation-anthropic>=0.1; extra == 'all'
Requires-Dist: openinference-instrumentation-crewai>=0.1; extra == 'all'
Requires-Dist: openinference-instrumentation-langchain>=0.1; extra == 'all'
Requires-Dist: openinference-instrumentation-llama-index>=3.0; extra == 'all'
Requires-Dist: openinference-instrumentation-openai-agents>=0.1; extra == 'all'
Requires-Dist: openinference-instrumentation-openai>=0.1; extra == 'all'
Requires-Dist: pydantic-ai>=0.1; extra == 'all'
Provides-Extra: anthropic
Requires-Dist: openinference-instrumentation-anthropic>=0.1; extra == 'anthropic'
Provides-Extra: crewai
Requires-Dist: openinference-instrumentation-crewai>=0.1; extra == 'crewai'
Provides-Extra: langchain
Requires-Dist: openinference-instrumentation-langchain>=0.1; extra == 'langchain'
Provides-Extra: litellm
Requires-Dist: litellm>=1.48; extra == 'litellm'
Provides-Extra: llamaindex
Requires-Dist: openinference-instrumentation-llama-index>=3.0; extra == 'llamaindex'
Provides-Extra: openai
Requires-Dist: openinference-instrumentation-openai>=0.1; extra == 'openai'
Provides-Extra: openai-agents
Requires-Dist: openinference-instrumentation-openai-agents>=0.1; extra == 'openai-agents'
Provides-Extra: pydantic-ai
Requires-Dist: pydantic-ai>=0.1; extra == 'pydantic-ai'
Description-Content-Type: text/markdown

# radicas — the Radicas Python SDK

One pip-installable SDK that instruments agentic frameworks and connects them to
**Radicas** correct-by-construction: right endpoint, API key, feature tag, tenant
semantics.

```bash
pip install "radicas[adk]"        # extras per framework: langchain, crewai, …
```

```python
import radicas

radicas.init(service="pricing-agent", feature="flight-pricing")
# ... run your agent — spans/metrics/logs export to Radicas ...
radicas.shutdown()                # optional: init() registers it via atexit
```

- No API key → **LOCAL** lab mode (`http://localhost:4317`, gRPC, no auth —
  a local OTLP collector).
- `RADICAS_API_KEY` / `api_key=` → **ONLINE** (`https://ingest.radicas.io`,
  Bearer auth; the tenant is resolved from the key by the gateway — the client
  never sends it).

Full documentation: [docs/sdk/](https://github.com/radicas-ai/radicas-integrations/tree/main/docs/sdk) (staging area for the
customer docs-site). Developing: `sdk/python/tests` runs with plain `pytest`; the
`src/radicas/_generated/` module is emitted by `make registry-gen` — never edit it
by hand.
