---
id: gql
version: "4.0.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# gql — GraphQL client for Python

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install gql
uv add gql
poetry add gql

## Description

# GQL

This is a GraphQL client for Python.
Plays nicely with `graphene`, `graphql-core`, `graphql-js` and any other GraphQL implementation
compatible with the [GraphQL specification](https://spec.graphql.org).

GQL architecture is inspired by `React-Relay` and `Apollo-Client`.

[![GitHub-Actions][gh-image]][gh-url]
[![pyversion][pyversion-image]][pyversion-url]
[![pypi][pypi-image]][pypi-url]
[![Anaconda-Server Badge][conda-image]][conda-url]
[![codecov][codecov-image]][codecov-url]

[gh-image]: https://github.com/graphql-python/gql/workflows/Tests/badge.svg
[gh-url]: https://github.com/graphql-python/gql/actions?query=workflow%3ATests
[pyversion-image]: https://img.shields.io/pypi/pyversions/gql
[pyversion-url]: https://pypi.org/project/gql/
[pypi-image]: https://img.shields.io/pypi/v/gql.svg?style=flat
[pypi-url]: https://pypi.org/project/gql/
[conda-image]: https://img.shields.io/conda/vn/conda-forge/gql.svg
[conda-url]: https://anaconda.org/conda-forge/gql
[codecov-image]: https://codecov.io/gh/graphql-python/gql/branch/master/graph/badge.svg
[codecov-url]: https://codecov.io/gh/graphql-python/gql

## Documentation

The complete documentation for GQL can be found...

## AI interpretation — verify before relying

GQL is a GraphQL client for Python that executes queries, mutations, and subscriptions against GraphQL servers using multiple transport protocols (HTTP, WebSockets, and others), with support for both sync and async execution.

Verdict: GQL is a production-stable, actively maintained GraphQL client with low install friction and permissive licensing. Its broad protocol support and dual sync/async capability make it suitable for most GraphQL integration scenarios. No known vulnerabilities reported.

[View on SkillFed](https://skillfed.io/packages/gql) · [View on PyPI](https://pypi.org/project/gql/)