Skip to main content

NoSQL object model database for django ORM integration

Project description

Build Status Build status Documentation Status License: GPLv3 Organization Views PRs Welcome GitHub pull-requests Language


Django like models for NoSQL database Firestore Integrating with django's ORM. This is a fork and improvement of firebase_orm project which was initially forked from xavx0z and stopped maintaining it.

I made a few changes and improvements to suit my liking:

  1. Changed the need of creating a second file in the root of your django project to now only require that you define the neccessary configurations in your project's settings module. Note that django is now an explicit dependency
  2. Created a new package for this app on pypi under django-firebase-orm

It is my desire to continue the development of this project and thus welcome all developers wishing to contribute via improving documentation, bug fixes, test coverage, new features, etc.


$ pip install django-firebase-orm


In your project settings add the following configuration variables

FIREBASE_ORM_CERTIFICATE = 'path/to/serviceAccountKey.json'


: Once you have created a Firebase console project and downloaded a JSON file with your service account credentials.


: The bucket name must not contain gs:// or any other protocol prefixes. For example, if the bucket URL displayed in the Firebase console is gs://, pass the string


Create model:

from firebase_orm import models

class Article(models.Model):
    headline = models.TextField()
    type_article = models.TextField(db_column='type')

    class Meta:
        db_table = 'medications'

    def __str__(self):
        return self.headline

Using The API:

Creating objects

To represent cloud firestore data in Python objects, FirebaseORM uses an intuitive system: A model class represents a collection, and an instance of that class represents a document in collection.

To create an object, instantiate it using keyword arguments to the model class, then call save() to save it to the database.

# Import the models we created
>>> from models import Article
# Create a new Article.
>>> a = Article(headline='Django is cool')
# Save the object into the database. You have to call save() explicitly.

Retrieving all objects

The simplest way to retrieve documents from a collections is to get all of them. To do this, use the all() method on a Manager as you would in normal django:

>>> all_Article = Article.objects.all()

The all() method returns a list instance Article of all the collection in the database.

# Now it has an ID.
# Fields are represented as attributes on the Python object.
>>> a.headline
'Django is cool'

Saving changes to objects

To save changes to an object that's already in the database, use save().

Given a Article instance a that has already been saved to the database, this example changes its name and updates its record in the database:

>>> a.headline = 'Django-Firebase-ORM is awesome'

This performs an document.update() method behind the scenes. FirebaseORM doesn't hit the database until you explicitly call save().

# Firebase ORM provides a rich database lookup API.
>>> Article.objects.get(id=1)
<Article: Django-Firebase-ORM is awesome>
>>> Article.objects.get(id=2)
Traceback (most recent call last):
DoesNotExist: Article matching query does not exist.

Field options:

The following arguments are available to all field types. All are optional.


If contains characters that aren't allowed in Python variable names -- use db_column. The name of the firestore key in document to use for this field. If this isn't given, FirebaseORM will use the field's name.

Field types:


class AutoField()

By default, FirebaseORM gives each model the following field:

id = models.AutoField(primary_key=True)


**class TextField(**options)**

Text string Up to 1,048,487 bytes (1 MiB - 89 bytes). Only the first 1,500 bytes of the UTF-8 representation are considered by queries.

TextField has not extra required argument.


  1. firebase-admin
  2. grpcio
  3. django

Building from Source for Developers

$ git clone
$ cd django-firebase-orm


See the Contributing File

See the Pull Request File


Read the license here


Thanks to joewalk102 for forking the original project without whom this project would not be possible.

TralahTek TralahM TralahM


TralahM TralahM



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-firebase-orm-0.6.1.tar.gz (8.1 kB view hashes)

Uploaded Source

Built Distribution

django_firebase_orm-0.6.1-py36-none-any.whl (20.8 kB view hashes)

Uploaded Python 3.6

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page