axio-transport-anthropic 0.4.0

Anthropic Claude transport for Axio

axio-transport-anthropic

Anthropic Claude transport for axio.

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

Features

• All Claude models — Opus, Sonnet, Haiku; configurable via ANTHROPIC_MODELS
• 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]"

Or as part of the full TUI bundle:

pip install "axio-tui[anthropic]"

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

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
max_retries	10	Max retry attempts on 429/529
retry_base_delay	5.0	Base delay (seconds) for exponential backoff

Part of the axio ecosystem

axio · axio-tui · axio-transport-openai · axio-transport-codex

License

MIT