graphql-python/gql

Health v2 · maintenance only

Adoption not part of the score

1681 stars · 195 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

GQL is a GraphQL client library for Python supporting queries, mutations, and subscriptions over HTTP and websockets transports. It offers sync and async usage, local request validation against a schema, file uploads, batching, a DSL for composing queries, and a CLI for running queries or downloading schemas.

Use cases

• query a GraphQL API from Python
• subscribe to GraphQL subscriptions over websockets
• validate GraphQL requests locally against a schema
• upload files via GraphQL mutations
• download a GraphQL schema from the command line
• run concurrent async GraphQL requests
• compose GraphQL queries dynamically with a DSL

When to choose

• you need a full-featured Python GraphQL client with async and subscription support
• you want local query validation against a GraphQL schema
• you need multiple transports (HTTP, websockets, AppSync, Phoenix channels)
• you want a CLI to fetch schemas or run queries

When to avoid

• you need a GraphQL server implementation rather than a client
• you are not working with GraphQL APIs
• you need a JavaScript or non-Python client

Facets

library · maturity stable

graphql-client http-client websocket apis web-development backend developer-tools python cross-platform cli graphql async subscriptions dsl schema-validation file-upload

Member repositories

For agents

markdown · JSON · MCP: product_card(name="graphql-python/gql")