genblaze-langsmith 0.2.1

LangSmith tracer backend for genblaze

genblaze-langsmith

LangSmith tracer backend for genblaze — AI-pipeline observability for generative media, with every run, step, and asset traced alongside its SHA-256 provenance manifest.

genblaze-langsmith plugs a LangSmithTracer into genblaze's observability stack, forwarding pipeline spans, provider calls, and manifest events to a LangSmith project. Combine it with genblaze's existing OTelTracer, LoggingTracer, or CompositeTracer for multi-destination tracing across your generative AI workflows.

Why genblaze-langsmith

• End-to-end AI pipeline traces — every provider call (Sora, Veo, Runway, Flux, ElevenLabs, …) appears as a LangSmith span with prompt, model, params, cost, and manifest hash.
• Drop-in tracer — attach to Pipeline(tracer=…); no code changes to providers or steps.
• Composable — wrap with CompositeTracer to send to LangSmith + OTel + logs simultaneously.
• Project-aware — traces land in the LangSmith project of your choice via standard LANGSMITH_* env vars.
• Works offline — tracer no-ops if LangSmith isn't configured; no production risk.

Install

pip install genblaze-langsmith

Quickstart

pip install genblaze-core genblaze-langsmith
export LANGSMITH_API_KEY="..."
export LANGSMITH_PROJECT="genblaze-prod"

from genblaze_core import Modality, Pipeline
from genblaze_core.testing import MockVideoProvider
from genblaze_langsmith import LangSmithTracer

tracer = LangSmithTracer()   # reads LANGSMITH_* env vars

run, manifest = (
    Pipeline("traced-demo", tracer=tracer)
    .step(MockVideoProvider(), model="mock-v1",
          prompt="a drone shot over a city at dusk",
          modality=Modality.VIDEO)
    .run()
)

# Span with prompt, model, manifest hash, duration now appears in LangSmith
print(manifest.canonical_hash)

Compose with other tracers:

from genblaze_core import CompositeTracer, LoggingTracer, OTelTracer
from genblaze_langsmith import LangSmithTracer

tracer = CompositeTracer([LangSmithTracer(), OTelTracer(), LoggingTracer()])
# Pipeline("…", tracer=tracer)…

Credentials

Env var	Notes
LANGSMITH_API_KEY	LangSmith API key
LANGSMITH_PROJECT	Target project (optional; defaults to LangSmith default)
LANGSMITH_ENDPOINT	Override the LangSmith endpoint (optional)

Documentation

• Main repo: https://github.com/backblaze-labs/genblaze
• Observability docs: https://github.com/backblaze-labs/genblaze/tree/main/docs/features

Related packages

• genblaze-core — the pipeline SDK
• genblaze-s3 — durable storage on Backblaze B2 and other S3-compatible backends

License

MIT