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

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.0.8
File	Interpreter	ABI	Platform	Reset
wandb_agentstream-1.0.8-py3-none-any.whl 1.3 MB Sep 4, 2026	Python 3	none	any	Details

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

Download URL	wandb_agentstream-1.0.8-py3-none-any.whl
Size	1.3 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`7964d13d70d0e8de1267e72524851975e4a4f9fbece1ddd7cf9f4cbb98c4c0c5`
BLAKE2b-256 checksum How to use checksums	`9fdd43868a5cadad954e487b40e746b14c75042ffc49cd78cb8b6e5818f82ce0`
Upload date	Sep 4, 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/3f4b8c75e0ad6cbe90f8cbd10bd5274527fe4535

Workflow

Publishing configuration: github.com/wandb/agentstream/blob/3f4b8c75e0ad6cbe90f8cbd10bd5274527fe4535/.github/workflows/release.yml
Publishing logs: github.com/wandb/agentstream/actions/runs/33874693050/attempts/1

Artifact

Subject: wandb_agentstream-1.0.8-py3-none-any.whl
SHA-256 checksum: 7964d13d70d0e8de1267e72524851975e4a4f9fbece1ddd7cf9f4cbb98c4c0c5 Verifying attestations