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.1rc2

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.1rc2
File	Interpreter	ABI	Platform	Reset
wandb_agentstream-1.1.1rc2-py3-none-any.whl 1.5 MB Oct 12, 2026	Python 3	none	any	Details

Release files / wandb_agentstream-1.1.1rc2-py3-none-any.whl

Download URL	wandb_agentstream-1.1.1rc2-py3-none-any.whl
Size	1.5 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`53585996042e67af64c1a52bef0bd55b037dbbd03ea1cb90bd5cc0b4c2d5ccf7`
BLAKE2b-256 checksum How to use checksums	`bc0830683e25c78ca6c6becd21bc259950a2701f59fbd02a77984b9e1647a7a1`
Upload date	Oct 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.8`