axio-transport-anthropic

PyPI Python License: MIT

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

Project links

Data verified by PyPI on Jul 23, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for mosquito from gravatar.com mosquito

GitHub Statistics

Data verified by PyPI on Jul 23, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT

Requires

Python >=3.12

Provides Extra

tui vertexai

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

axio_transport_anthropic-0.10.0.tar.gz (12.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

axio_transport_anthropic-0.10.0-py3-none-any.whl (9.9 kB view details)

Uploaded Python 3

File details

Details for the file axio_transport_anthropic-0.10.0.tar.gz.

File metadata

File hashes

Hashes for axio_transport_anthropic-0.10.0.tar.gz
Algorithm Hash digest
SHA256 b818bbcdc32ccbd0b9578d9f03b858402fb222676019b4802011aaea1459d790
MD5 ed82015df15cd535c4d8e571c486c197
BLAKE2b-256 d08e92ac8d032d8666e3f6ccdaf802fbde1efd6d5b2392d59daaa7133d2b48b6

See more details on using hashes here.

Provenance

The following attestation bundles were made for axio_transport_anthropic-0.10.0.tar.gz:

Publisher: publish.yml on mosquito/axio-agent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file axio_transport_anthropic-0.10.0-py3-none-any.whl.

File metadata

File hashes

Hashes for axio_transport_anthropic-0.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 845ced1cc112396ed8007eac3ad5fe64b149402674a7c4a02e819a6ffb780850
MD5 fa29ade802b0303176c4d5a300b3523d
BLAKE2b-256 df6da91deb512f2a69b216a4494a139e0c4a520bc88f44d55a1e6a6e001fa3f5

See more details on using hashes here.

Provenance

The following attestation bundles were made for axio_transport_anthropic-0.10.0-py3-none-any.whl:

Publisher: publish.yml on mosquito/axio-agent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page