axio-transport-anthropic

Anthropic Claude transport for axio.

Streams Claude responses over the Anthropic Messages API using aiohttp and SSE parsing. Supports direct API, Vertex AI, prompt caching, extended thinking, and automatic retry on rate-limit and overload errors.

Features

All Claude models — Opus, Sonnet, Haiku; configurable via ANTHROPIC_MODELS
Vertex AI — use Claude via Google Cloud with ADC authentication
Prompt caching — cache_control: ephemeral applied automatically to the system prompt and the last tool definition
Extended thinking — ReasoningDelta events emitted for thinking blocks
Retry logic — automatic backoff on 429 / 529; honours Retry-After header
TUI integration — settings screen for API key and model selection

Installation

pip install axio-transport-anthropic

With the TUI settings screen:

pip install "axio-transport-anthropic[tui]"

With Vertex AI support:

pip install "axio-transport-anthropic[vertexai]"

Usage

import asyncio
import aiohttp
from axio import Agent
from axio.context import MemoryContextStore
from axio_transport_anthropic import AnthropicTransport, ANTHROPIC_MODELS

async def main() -> None:
    async with aiohttp.ClientSession() as session:
        transport = AnthropicTransport(
            api_key="sk-ant-...",
            model=ANTHROPIC_MODELS["claude-sonnet-4-6"],
            session=session,
        )
        agent = Agent(system="You are helpful.", tools=[], transport=transport)
        ctx = MemoryContextStore()
        print(await agent.run("Hello!", ctx))

asyncio.run(main())

Set the API key via environment variable instead of passing it directly:

export ANTHROPIC_API_KEY="sk-ant-..."

Vertex AI

transport = AnthropicTransport(
    vertexai=True,
    project="my-gcp-project",
    location="us-east5",
    session=session,
)
# Uses Application Default Credentials (gcloud auth application-default login)

Models

Model ID	Context	Max output	Notes
`claude-opus-4-6`	1 M	128 k	Most capable
`claude-sonnet-4-6`	1 M	64 k	Balanced (default)
`claude-haiku-4-5-20251001`	200 k	64 k	Fastest / cheapest
`claude-opus-4-5`	200 k	64 k	—
`claude-sonnet-4-5`	200 k	64 k	—

Configuration

Parameter	Default	Description
`api_key`	`""`	Anthropic API key
`model`	`claude-sonnet-4-6`	Active model
`base_url`	`https://api.anthropic.com/v1`	API base URL
`vertexai`	`False`	Use Vertex AI backend
`project`	`""`	GCP project ID (Vertex AI)
`location`	`""`	GCP region, e.g. `us-east5` (Vertex AI)
`max_retries`	`10`	Max retry attempts on 429/529
`retry_base_delay`	`5.0`	Base delay (seconds) for exponential backoff

License

MIT

Metadata

Release files for axio-transport-anthropic 0.11.1

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

Source distribution (sdist)

Source distribution for axio-transport-anthropic 0.11.1
File	Size	Uploaded
axio_transport_anthropic-0.11.1.tar.gz	24.1 kB	Aug 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for axio-transport-anthropic 0.11.1
File	Interpreter	ABI	Platform	Reset
axio_transport_anthropic-0.11.1-py3-none-any.whl 15.0 kB Aug 29, 2026	Python 3	none	any	Details

Total release size: 39.0 kB

Release files / axio_transport_anthropic-0.11.1.tar.gz

Download URL	axio_transport_anthropic-0.11.1.tar.gz
Size	24.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`0f573670ae6d4990eb254ddc30a6abafdf9ab86e4c7bc205db1fec6380e6a3c4`
BLAKE2b-256 checksum How to use checksums	`44721a1fbeba972c20920aefb6cc58cd155160184e4f00df55e5ffe1d01cfbdf`
Upload date	Aug 29, 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/mosquito/axio-agent
Publishing commit: github.com/mosquito/axio-agent/tree/3ed5e93f4df57d2d9885d91ffc6629be34a2ca56

Workflow

Publishing configuration: github.com/mosquito/axio-agent/blob/3ed5e93f4df57d2d9885d91ffc6629be34a2ca56/.github/workflows/publish.yml
Publishing logs: github.com/mosquito/axio-agent/actions/runs/33267945186/attempts/1

Artifact

Subject: axio_transport_anthropic-0.11.1.tar.gz
SHA-256 checksum: 0f573670ae6d4990eb254ddc30a6abafdf9ab86e4c7bc205db1fec6380e6a3c4 Verifying attestations

Release files / axio_transport_anthropic-0.11.1-py3-none-any.whl

Download URL	axio_transport_anthropic-0.11.1-py3-none-any.whl
Size	15.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d519f8fe1418fe2e73abb6bbcfd224f46865f78357f6e794e7959fcfbde23b5c`
BLAKE2b-256 checksum How to use checksums	`b78f3ccf75ca785711723faaf454558f0a7cef3d92136d41933739a4bd478f68`
Upload date	Aug 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mosquito/axio-agent
Publishing commit: github.com/mosquito/axio-agent/tree/3ed5e93f4df57d2d9885d91ffc6629be34a2ca56

Workflow

Publishing configuration: github.com/mosquito/axio-agent/blob/3ed5e93f4df57d2d9885d91ffc6629be34a2ca56/.github/workflows/publish.yml
Publishing logs: github.com/mosquito/axio-agent/actions/runs/33267945186/attempts/1

Artifact

Subject: axio_transport_anthropic-0.11.1-py3-none-any.whl
SHA-256 checksum: d519f8fe1418fe2e73abb6bbcfd224f46865f78357f6e794e7959fcfbde23b5c Verifying attestations