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

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.3
File	Size	Uploaded
axio_transport_anthropic-0.11.3.tar.gz	24.1 kB	Sep 17, 2026	Details

Built distribution (wheel)

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

Total release size: 39.0 kB

Release files / axio_transport_anthropic-0.11.3.tar.gz

Download URL	axio_transport_anthropic-0.11.3.tar.gz
Size	24.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`41a628d2d49a459939a901823b3f7374d596d2ca64dfb4baaaf5ba6a82eaba3c`
BLAKE2b-256 checksum How to use checksums	`7fc8c090cc1dfc0bded92ffe0707012e76a5ff507cb6c20d8b3b491e94d7153d`
Upload date	Sep 17, 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/da3244f9c622fba4271e423256ac2682834db1d3

Workflow

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

Artifact

Subject: axio_transport_anthropic-0.11.3.tar.gz
SHA-256 checksum: 41a628d2d49a459939a901823b3f7374d596d2ca64dfb4baaaf5ba6a82eaba3c Verifying attestations

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

Download URL	axio_transport_anthropic-0.11.3-py3-none-any.whl
Size	15.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`81094f79b93e63efe8f09d7836f39e71531d0aeb056ce8fd5babac35f9099706`
BLAKE2b-256 checksum How to use checksums	`035a04ac887ad15836178f98cb85dce76674095940d133a54c817b58d4e7d5e0`
Upload date	Sep 17, 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/da3244f9c622fba4271e423256ac2682834db1d3

Workflow

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

Artifact

Subject: axio_transport_anthropic-0.11.3-py3-none-any.whl
SHA-256 checksum: 81094f79b93e63efe8f09d7836f39e71531d0aeb056ce8fd5babac35f9099706 Verifying attestations