observra

Zero-touch tracing and gateway routing for LLM SDKs — configure once, keep writing the provider SDK's own client exactly as before.

Install

pip install observra

Configure

Only gateway_key is required — gateway_url defaults to the production gateway (https://gateway.observra.in):

import observra

observra.configure(gateway_key="obs_live_xxx")

Or via environment variable (no explicit configure() call needed):

export OBSERVRA_GATEWAY_KEY="obs_live_xxx"

Use

No wrapper client — write plain provider SDK code exactly as you already would. configure() transparently patches the SDK (Gemini) and, for every known provider host, patches httpx itself (OpenAI, Anthropic — and Gemini too, for non-SDK callers), so any request to those hosts routes through the gateway and gets traced/guardrailed, no matter which library actually made the call:

from google import genai

client = genai.Client(api_key="AIza...")  # your own Gemini key, forwarded as-is

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="Summarize this support ticket: ...",
)
print(response.text)

from openai import OpenAI

client = OpenAI(api_key="sk-...")  # your own OpenAI key
response = client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "..."}])

from anthropic import Anthropic

client = Anthropic(api_key="sk-ant-...")  # your own Anthropic key
response = client.messages.create(model="claude-3-5-sonnet-20241022", max_tokens=1024, messages=[{"role": "user", "content": "..."}])

Same for async clients, and for any framework integration that builds one of these internally — e.g. LangChain's ChatGoogleGenerativeAI routes through the gateway automatically too, no extra step. See examples/raw_http_gemini.py for the same guarantee at the raw-HTTP level — no provider SDK at all, just httpx pointed straight at Google's real endpoint.

Inside a LangChain agent — instrument() additionally traces every step (agent/chain/tool boundaries) under one trace, on top of the LLM-call-level tracing configure() already gives you:

observra.instrument()

Guardrails (PII/secret detection on prompts and responses) run on every call automatically — violations are recorded as span events (guardrail.violation), the payload itself is never blocked or altered.

See examples/ for full runnable scripts, and traces show up in your Observra dashboard's Request Flow view.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

observra_sdk_python-0.1.5.tar.gz (48.3 kB view details)

Uploaded Aug 12, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

observra_sdk_python-0.1.5-py3-none-any.whl (51.9 kB view details)

Uploaded Aug 12, 2026 Python 3

File details

Details for the file observra_sdk_python-0.1.5.tar.gz.

File metadata

Download URL: observra_sdk_python-0.1.5.tar.gz
Upload date: Aug 12, 2026
Size: 48.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for observra_sdk_python-0.1.5.tar.gz
Algorithm	Hash digest
SHA256	`626d58350c3469b7a09a3018a6e4dc62d76fbb988ed14e8e1762f95dc28e822c`
MD5	`8576c167cfc809f6107bf796f450a550`
BLAKE2b-256	`06245f61a01f6ea0fc891aa7795a2534839d6b17d8f511ce81edaaf18acc31be`

See more details on using hashes here.

Provenance

The following attestation bundles were made for observra_sdk_python-0.1.5.tar.gz:

Publisher: publish.yml on aviasoletechnologies/observra-sdk-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: observra_sdk_python-0.1.5.tar.gz
- Subject digest: 626d58350c3469b7a09a3018a6e4dc62d76fbb988ed14e8e1762f95dc28e822c
- Sigstore transparency entry: 2433072964
- Sigstore integration time: Aug 12, 2026
Source repository:
- Permalink: aviasoletechnologies/observra-sdk-python@e7dddec33d2913d15fd4ab1b115e7103c582eea9
- Branch / Tag: refs/heads/main
- Owner: https://github.com/aviasoletechnologies
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@e7dddec33d2913d15fd4ab1b115e7103c582eea9
- Trigger Event: push