Metadata-Version: 2.5
Name: gigaflow
Version: 0.6.3
Summary: GigaFlow Python SDK — OTel-native agent tracing (sdk-spec 1.0.0).
Project-URL: Homepage, https://gigaflow.ai
Project-URL: Documentation, https://github.com/GigaFlowAI/gigarepo/tree/main/contracts/sdk
Project-URL: Repository, https://github.com/GigaFlowAI/gigarepo
Project-URL: Issues, https://github.com/GigaFlowAI/gigarepo/issues
Project-URL: Changelog, https://github.com/GigaFlowAI/gigarepo/blob/main/contracts/sdk/CHANGELOG.md
Author: GigaFlow
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agents,gigaflow,llm,observability,opentelemetry,otlp,tracing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Monitoring
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: opentelemetry-exporter-otlp-proto-http<2,>=1.20
Requires-Dist: opentelemetry-sdk<2,>=1.20
Requires-Dist: pyyaml<7,>=6
Provides-Extra: grpc
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<2,>=1.20; extra == 'grpc'
Provides-Extra: otlp
Description-Content-Type: text/markdown

# GigaFlow Python SDK

Official Python SDK for [GigaFlow](https://gigaflow.ai) agent tracing. Install
name and import remain `gigaflow`. This package implements **sdk-spec `1.0.0`**
([`contracts/sdk`](https://github.com/GigaFlowAI/gigarepo/tree/main/contracts/sdk)).

It is the Python cell of the same contract as `@gigaflow/sdk`. Import is inert:
no threads, sockets, or export until `configure()`.

This is the tracing SDK, not the yanked `gigaflow` CLI (`0.2.1`–`0.5.0`).

## Install

```bash
pip install gigaflow
```

Managed OTLP HTTP/protobuf is included by default. Optional gRPC:

```bash
pip install 'gigaflow[grpc]'
```

## Use

```python
from gigaflow import configure, shutdown, user_input, llm_call, tool_invocation

configure(
    service_name="checkout-agent",
    endpoint="https://api.gigaflow.io",
    api_key="...",
)

with user_input(content="refund order 42"):
    with llm_call(request_model="claude", completion="ok"):
        pass
    with tool_invocation(name="refund", output="done"):
        pass

shutdown()
```

`endpoint` may also come from `OTEL_EXPORTER_OTLP_ENDPOINT`. Pass an existing
`tracer_provider` to join a host OpenTelemetry pipeline (embedded mode).
`inject()` / `extract()` use W3C `traceparent`.

## Versioning

This package is `0.x`: the **minor** is the breaking position. `0.7.0` may
break `0.6.x`; a patch will not. Pin `~0.6.0` if you need that guarantee.

The emitted wire format is versioned separately as
`gigaflow.schema.version` (`2026-07`). The declared spec is
`gigaflow.__spec_version__` and the resource attribute
`gigaflow.sdk.spec_version`.

## Licence

Apache-2.0.
