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

1 1 3 3

introduction

Get started

api

API reference

GitHub

Why aiographql-client#

1 2 2 3

zap Async-first

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

plug Multiple transports

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

broadcast Subscriptions

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

shield-check Schema validation

Client-side query validation powered by graphql-core.

package Bring your own models

Decode straight into dataclasses or Pydantic models with explicit codecs.

rocket Production-ready

Battle-tested in high-throughput async services.

1 2 2 3

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.