Strawberry GraphQL Django Integration

PyPI - Python Version

Strawberry GraphQL Django integration provides powerful tools to build GraphQL APIs with Django. Automatically generate GraphQL types, queries, mutations, and resolvers from your Django models with full type safety.

Installation

pip install strawberry-graphql-django

Features

🍓 Automatic Type Generation - Generate GraphQL types from Django models with full type safety
🔍 Advanced Filtering - Powerful filtering system with lookups (contains, exact, in, etc.)
📄 Pagination - Built-in offset and cursor-based (Relay) pagination
📊 Ordering - Sort results by any field with automatic ordering support
🔐 Authentication & Permissions - Django auth integration with flexible permission system
✨ CRUD Mutations - Auto-generated create, update, and delete mutations with validation
⚡ Query Optimizer - Automatic select_related and prefetch_related to prevent N+1 queries
🐍 Django Integration - Works with Django views (sync and async), forms, and validation
🐛 Debug Toolbar - GraphiQL integration with Django Debug Toolbar for query inspection

Quick Start

# models.py
from django.db import models


class Fruit(models.Model):
    name = models.CharField(max_length=20)
    color = models.ForeignKey("Color", on_delete=models.CASCADE, related_name="fruits")


class Color(models.Model):
    name = models.CharField(max_length=20)

# types.py
import strawberry_django
from strawberry import auto
from . import models


@strawberry_django.type(models.Fruit)
class Fruit:
    id: auto
    name: auto
    color: "Color"


@strawberry_django.type(models.Color)
class Color:
    id: auto
    name: auto
    fruits: list[Fruit]

# schema.py
import strawberry
import strawberry_django
from strawberry_django.optimizer import DjangoOptimizerExtension
from .types import Fruit


@strawberry.type
class Query:
    fruits: list[Fruit] = strawberry_django.field()


schema = strawberry.Schema(
    query=Query,
    extensions=[DjangoOptimizerExtension],
)

# urls.py
from django.urls import path
from strawberry.django.views import AsyncGraphQLView
from .schema import schema

urlpatterns = [
    path("graphql/", AsyncGraphQLView.as_view(schema=schema)),
]

That's it! You now have a fully functional GraphQL API with:

Automatic type inference from Django models
Optimized database queries (no N+1 problems)
Interactive GraphiQL interface at /graphql/

Visit http://localhost:8000/graphql/ and try this query:

query {
  fruits {
    id
    name
    color {
      name
    }
  }
}

Next Steps

Check out our comprehensive documentation:

📚 Getting Started Guide - Complete tutorial with examples
🎓 Example App - Full-featured e-commerce application
📖 Documentation - In-depth guides and API reference
💬 Discord Community - Get help and share your projects

Contributing

We welcome contributions! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated 😊

Quick Start:

git clone https://github.com/strawberry-graphql/strawberry-django
cd strawberry-django
pre-commit install

Then run tests with make test or make test-dist for parallel execution.

Community

💬 Discord - Join our community for help and discussions
🐛 GitHub Issues - Report bugs or request features
💡 GitHub Discussions - Ask questions and share ideas

License

This project is licensed under the MIT License.

Metadata

Release files for strawberry-graphql-django 0.92.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for strawberry-graphql-django 0.92.1
File	Size	Uploaded
strawberry_graphql_django-0.92.1.tar.gz	96.9 kB	Oct 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for strawberry-graphql-django 0.92.1
File	Interpreter	ABI	Platform	Reset
strawberry_graphql_django-0.92.1-py3-none-any.whl 120.7 kB Oct 4, 2026	Python 3	none	any	Details

Total release size: 217.5 kB

Release files / strawberry_graphql_django-0.92.1.tar.gz

Download URL	strawberry_graphql_django-0.92.1.tar.gz
Size	96.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`6a37f8c890b8ca6ecbd1ddb3d7071d379d8c94c8b7ab5c0357ba6b6b9033b96b`
BLAKE2b-256 checksum How to use checksums	`46ee4430a92660675ff8d098775db11e7dd555fe0dc1080b5adb658b495f0e18`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / strawberry_graphql_django-0.92.1-py3-none-any.whl

Download URL	strawberry_graphql_django-0.92.1-py3-none-any.whl
Size	120.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7720784311d2b4e6d3ef751b8f2c13fd4a30250b7315dcc8a7be0879dd637410`
BLAKE2b-256 checksum How to use checksums	`f9f0c928e613ce16a223a016acf37fb2c946f9d8e6933ff0011c530d8dc82dff`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`