agentstream

Read, transform, and write AI agent session logs across formats (Claude, Codex, Gemini) with AG-UI events as the canonical format.

Installation

pip install agentstream

Quick Start

import agentstream

# Discover all agent sessions
sessions = agentstream.discover_sessions("~/myproject")

# Read as grouped messages
for msg in agentstream.read_messages(sessions[0]):
    print(f"{msg.role}: {msg.text[:100]}")
    for tc in msg.tool_calls:
        print(f"  -> {tc.name}({tc.args})")

Development

uv venv
uv pip install -e ".[dev]"

# Run tests with coverage
uv run pytest

# Type checking (ty is Astral's fast type checker)
uv run ty check

# Linting
uv run ruff check agentstream

Version Management

Python and Node.js versions are centralized in .python-version and .node-version files at the repo root.

Auto-updated from version files:

CI workflows
devcontainer
Docker builds (via make up in backend/)

Manual updates required when changing versions:

File	Settings to update
`pyproject.toml`	`requires-python`, `target-version` (ruff), `python-version` (ty)
`daemon/pyproject.toml`	`requires-python`, `target-version`
`backend/api/pyproject.toml`	`requires-python`, `target-version`

Version policy:

SDK (agentstream): Supports Python 3.12+ for broad compatibility
Backend services (daemon, api): Require Python 3.13+ (we control deployment)

License

MIT

Metadata

Release files for wandb-agentstream 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for wandb-agentstream 1.1.0
File	Interpreter	ABI	Platform	Reset
wandb_agentstream-1.1.0-py3-none-any.whl 1.3 MB Sep 22, 2026	Python 3	none	any	Details

Release files / wandb_agentstream-1.1.0-py3-none-any.whl

Download URL	wandb_agentstream-1.1.0-py3-none-any.whl
Size	1.3 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`640aceae6d7d66290b79a2025de6a776f01031efa33202bc8080750628789d65`
BLAKE2b-256 checksum How to use checksums	`0639bdbb0b6878a8d39a97175303b4b4eb171e329e075bc7ab3ee3bce48dffba`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/wandb/agentstream
Publishing commit: github.com/wandb/agentstream/tree/ce987a6185c4566f5f99a7b26e1dd4cf118ed314

Workflow

Publishing configuration: github.com/wandb/agentstream/blob/ce987a6185c4566f5f99a7b26e1dd4cf118ed314/.github/workflows/release.yml
Publishing logs: github.com/wandb/agentstream/actions/runs/35791668237/attempts/1

Artifact

Subject: wandb_agentstream-1.1.0-py3-none-any.whl
SHA-256 checksum: 640aceae6d7d66290b79a2025de6a776f01031efa33202bc8080750628789d65 Verifying attestations