graphene-django

What it is and what it does

Graphene-Django is a bridge library that lets you build GraphQL APIs directly from your Django models without writing boilerplate schema definitions. It sits between Django and graphene, automatically converting your Django model structure into a queryable GraphQL schema and wiring in Django's built-in authentication, permissions, and form validation.

You define your GraphQL types by wrapping Django models in DjangoObjectType classes, then expose them through a schema that graphene-django serves via a Django view. The library handles common tasks like filtering, pagination, and permission checks, so you spend less time on API plumbing and more on business logic. It's designed for developers already working in Django who want to add a GraphQL layer without learning a separate API framework.

Use it for

• Expose existing Django models as a GraphQL API without rewriting model definitions or authentication logic
• Build a modern frontend backed by a Django GraphQL endpoint with automatic schema introspection
• Add filtering and pagination to Django querysets via GraphQL without custom resolver code
• Migrate from REST to GraphQL incrementally by wrapping Django views and models in GraphQL types
• Test GraphQL queries against Django models using the built-in GraphQLTestCase utility

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

graphene-django on PyPI

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained with recent commits and a large repository (4392 stars), indicating stable, community-backed development.

Requires Django to be installed and configured; GraphQL queries execute against your Django ORM, so database setup is a prerequisite.

License in practice

MIT license permits commercial and private use with minimal restrictions, making it suitable for most projects without licensing concerns.

Quickstart

pip install graphene-django

# In settings.py:
INSTALLED_APPS = ['graphene_django']
GRAPHENE = {'SCHEMA': 'myapp.schema.schema'}

# In schema.py:
import graphene
from graphene_django import DjangoObjectType

class MyType(DjangoObjectType):
    class Meta:
        model = MyModel

class Query(graphene.ObjectType):
    items = graphene.List(MyType)
    def resolve_items(self, info):
        return []

schema = graphene.Schema(query=Query)

Package facts

Evidence: graphene_django-3.2.3-py2.py3-none-any.whl

Tags

More Libraries packages

See also graphene · graphene-django-optimizer · graphene-file-upload · django-graphql-jwt · graphene-sqlalchemy · graphene-federation · strawberry-graphql-django · starlette-graphene3 · graphene-pydantic · Flask-GraphQL