Metadata-Version: 2.5
Name: gigaflow
Version: 0.6.1
Summary: OTel-native agent tracing for GigaFlow: four primitives, content policy, and OTLP HTTP/protobuf.
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: pyyaml<7,>=6
Provides-Extra: grpc
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<2,>=1.20; extra == 'grpc'
Requires-Dist: opentelemetry-exporter-otlp-proto-http<2,>=1.20; extra == 'grpc'
Requires-Dist: opentelemetry-sdk<2,>=1.20; extra == 'grpc'
Provides-Extra: otlp
Requires-Dist: opentelemetry-exporter-otlp-proto-http<2,>=1.20; extra == 'otlp'
Requires-Dist: opentelemetry-sdk<2,>=1.20; extra == 'otlp'
Description-Content-Type: text/markdown

# gigaflow

OTel-native agent tracing for [GigaFlow](https://gigaflow.ai). 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. It is not the yanked `gigaflow` CLI (`0.2.1`–`0.5.0`).

## Install

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

Managed export needs the `otlp` extra (`opentelemetry-sdk` and the OTLP HTTP
protobuf exporter). 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 pipeline (embedded mode).

## 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.
