Metadata-Version: 2.4
Name: guck-sdk
Version: 0.7.3
Summary: MCP-first telemetry store for AI debugging (Python SDK)
Author: Guck
License: MIT
Keywords: mcp,observability,telemetry
Requires-Python: >=3.9
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

# Guck Python SDK

Guck is a tiny, MCP-first telemetry store for AI debugging. This package is the
Python SDK that mirrors the JS `emit` behavior.

## Install

```sh
pip install guck-sdk
```

The distribution is `guck-sdk`, but the import name remains `guck`.

## Install (local dev)

```sh
uv pip install -e .
```

## Usage

```py
from guck import emit
from guck import install_auto_capture

emit({"message": "hello from python"})

# Optional: capture stdout/stderr automatically
handle = install_auto_capture()
print("hello from stdout")
handle.stop()
```

## Config

The SDK reads `.guck.json` in your repo root and honors the same environment
variables as the JS SDK:

- `GUCK_CONFIG_PATH`
- `GUCK_DIR`
- `GUCK_ENABLED`
- `GUCK_SERVICE`
- `GUCK_SESSION_ID`
- `GUCK_RUN_ID`

Auto-capture can be configured via `.guck.json`:

```json
{
  "sdk": {
    "enabled": true,
    "capture_stdout": true,
    "capture_stderr": true
  }
}
```
