Jonathan Kim 965ebdee13 Merge branch 'master' into v3 2020-06-27 11:14:09 +01:00
cookbook Warn if `fields` or `exclude` are not defined on `DjangoObjectType` (#981) 2020-06-11 11:09:52 +01:00 Make examples diff better against each other 2018-06-13 10:29:50 -04:00 Add `examples/cookbook-plain` to follow the plain tutorial 2017-02-14 20:23:45 +02:00
requirements.txt Bump django from 3.0.3 to 3.0.7 in /examples/cookbook-plain (#978) 2020-06-06 12:48:01 +01:00
setup.cfg Add `examples/cookbook-plain` to follow the plain tutorial 2017-02-14 20:23:45 +02:00

Cookbook Example Django Project

This example project demos integration between Graphene and Django. The project contains two apps, one named ingredients and another named recipes.

Getting started

First you'll need to get the source of the project. Do this by cloning the whole Graphene repository:

# Get the example project code
git clone
cd graphene-django/examples/cookbook

It is good idea (but not required) to create a virtual environment for this project. We'll do this using virtualenv to keep things simple, but you may also find something like virtualenvwrapper to be useful:

# Create a virtualenv in which we can install the dependencies
virtualenv env
source env/bin/activate

Now we can install our dependencies:

pip install -r requirements.txt

Now setup our database:

# Setup the database
./ migrate

# Load some example data
./ loaddata ingredients

# Create an admin user (useful for logging into the admin UI
# at
./ createsuperuser

Now you should be ready to start the server:

./ runserver

Now head on over to and run some queries! (See the Graphene-Django Tutorial for some example queries)