Async GraphQL Client

An asynchronous GraphQL client for Python and asyncio — built on aiohttp / httpx and graphql-core.

pip

pip install "aiographql-client[aiohttp,pydantic]"

poetry

poetry add "aiographql-client[aiohttp,pydantic]"

Why aiographql-client

Async-first

Built from the ground up on asyncio. No sync shim, no thread pool.

Multiple transports

aiohttp (default) and httpx. Swap freely, share sessions for production-grade connection pooling.

Subscriptions

First-class GraphQL subscriptions over WebSockets via aiohttp or websockets.

Schema validation

Client-side query validation powered by graphql-core.

Bring your own models

Decode straight into dataclasses or Pydantic models with explicit codecs.

Production-ready

Battle-tested in high-throughput async services.

Introduction

Install, quick start, and the mental model.

Examples

Queries, mutations, subscriptions, validation, data models.

Transports

aiohttp vs httpx, sessions, timeouts, retries, SOCKS proxies.

Data models

Dataclasses and Pydantic decoding patterns.

Python API

Full reference for client, transport, data, constants, exceptions.

Contributing

Local setup, tests, conventions, release process.