Skip to main content

A simple python wrapper for the Firebase API compatible with Python 3.7, supports social signup

Project description


A python connector library for firebase Firebase REST API. You can use this in a plain vanilla Python application or django application.

Key Highlights of Features

Compatible with Python 2.7 - 3.7




Social Signup


pip install pyfireconnect

Getting Started

Python Version

pyfireconnect was written for python 3 and tested with 2.7

Add pyfireconnect to your application

For use with only user based authentication we can create the following configuration:

import pyfireconnect

config = {
  "apiKey": "apiKey",
  "authDomain": "",
  "databaseURL": "",
  "storageBucket": ""

firebase = pyfireconnect.initialize(config)

We can optionally add a service account credential to our configuration that will allow our server to authenticate with Firebase as an admin and disregard any security rules.

import pyfireconnect

config = {
  "apiKey": "apiKey",
  "authDomain": "",
  "databaseURL": "",
  "storageBucket": "",
  "serviceAccount": "path/to/serviceAccountCredentials.json"

firebase = pyfireconnect.initialize(config)

Adding a service account will authenticate as an admin by default for all database queries, check out the Authentication documentation for how to authenticate users.

Use Services

A pyfireconnect app can use multiple Firebase services.

firebase.auth() - Authentication

firebase.database() - Database - Storage

Check out the documentation for each service for further details.


The sign_in_with_email_and_password() method will return user data including a token you can use to adhere to security rules.

Each of the following methods accepts a user token: get(), push(), set(), update(), remove() and stream().

# Get a reference to the auth service
auth = firebase.auth()

# Log the user in
user = auth.sign_in_with_email_and_password(email, password)

#social sign up
fb_access_token = "EAANUSasYcQEBAJNudphsPoizjpohueZA3nX7ZCFdpWlDmgJ19zDdu3dJQQ4sZBXDMA6KTqY58MBAK6kBeegZBnoVtRmHmAmkc26pAarUr6ycAYlZArUH2m5RbgEst2ms6mc5JVrSJGJsGyQOgdzRPeJkdIdEoekPG0DnJBdndsMce4ycD6OrEixZCcwPVKOiZBEKy0wTOJQ3wZDZD"

request_uri = 'http://localhost'

social_user = auth.social_signup(fb_access_token, "", request_uri)

# Get a reference to the database service
db = firebase.database()

# data to save
data = {
    "name": "Mortimer 'Morty' Smith"

# Pass the user's idToken to the push method
results = db.child("users").push(data, user['idToken'])

Token expiry

A user's idToken expires after 1 hour, so be sure to use the user's refreshToken to avoid stale tokens.

user = auth.sign_in_with_email_and_password(email, password)
# before the 1 hour expiry:
user = auth.refresh(user['refreshToken'])
# now we have a fresh token

Custom tokens

You can also create users using custom tokens, for example:

token = auth.create_custom_token("your_custom_id")

You can also pass in additional claims.

token_with_additional_claims = auth.create_custom_token("your_custom_id", {"premium_account": True})

You can then send these tokens to the client to sign in, or sign in as the user on the server.

user = auth.sign_in_with_custom_token(token)

Manage Users

Creating users

auth.create_user_with_email_and_password(email, password)

Note: Make sure you have the Email/password provider enabled in your Firebase dashboard under Auth -> Sign In Method.

Verifying emails


Sending password reset emails


Get account information


Refreshing tokens

user = auth.refresh(user['refreshToken'])


You can build paths to your data by using the child() method.

db = firebase.database()

Save Data


To save data with a unique, auto-generated, timestamp-based key, use the push() method.

data = {"name": "Mortimer 'Morty' Smith"}


To create your own keys use the set() method. The key in the example below is "Morty".

data = {"name": "Mortimer 'Morty' Smith"}


To update data for an existing entry use the update() method.

db.child("users").child("Morty").update({"name": "Mortiest Morty"})


To delete data for an existing entry use the remove() method.


multi-location updates

You can also perform multi-location updates with the update() method.

data = {
    "users/Morty/": {
        "name": "Mortimer 'Morty' Smith"
    "users/Rick/": {
        "name": "Rick Sanchez"


To perform multi-location writes to new locations we can use the generate_key() method.

data = {
    "users/"+ref.generate_key(): {
        "name": "Mortimer 'Morty' Smith"
    "users/"+ref.generate_key(): {
        "name": "Rick Sanchez"


Retrieve Data


Queries return a PyreResponse object. Calling val() on these objects returns the query data.

users = db.child("users").get()
print(users.val()) # {"Morty": {"name": "Mortimer 'Morty' Smith"}, "Rick": {"name": "Rick Sanchez"}}


Calling key() returns the key for the query data.

user = db.child("users").get()
print(user.key()) # users


Returns a list of objects on each of which you can call val() and key().

all_users = db.child("users").get()
for user in all_users.each():
    print(user.key()) # Morty
    print(user.val()) # {name": "Mortimer 'Morty' Smith"}


To return data from a path simply call the get() method.

all_users = db.child("users").get()


To return just the keys at a particular path use the shallow() method.

all_user_ids = db.child("users").shallow().get()

Note: shallow() can not be used in conjunction with any complex queries.


You can listen to live changes to your data with the stream() method.

def stream_handler(message):
    print(message["event"]) # put
    print(message["path"]) # /-K7yGTTEp7O549EzTYtI
    print(message["data"]) # {'title': 'pyfireconnect', "body": "etc..."}

my_stream = db.child("posts").stream(stream_handler)

You should at least handle put and patch events. Refer to "Streaming from the REST API" for details.

You can also add a stream_id to help you identify a stream if you have multiple running:

my_stream = db.child("posts").stream(stream_handler, stream_id="new_posts")

close the stream


Complex Queries

Queries can be built by chaining multiple query parameters together.

users_by_name = db.child("users").order_by_child("name").limit_to_first(3).get()

This query will return the first three users ordered by name.


We begin any complex query with order_by_child().

users_by_name = db.child("users").order_by_child("name").get()

This query will return users ordered by name.


Return data with a specific value.

users_by_score = db.child("users").order_by_child("score").equal_to(10).get()

This query will return users with a score of 10.

start_at and end_at

Specify a range in your data.

users_by_score = db.child("users").order_by_child("score").start_at(3).end_at(10).get()

This query returns users ordered by score and with a score between 3 and 10.

limit_to_first and limit_to_last

Limits data returned.

users_by_score = db.child("users").order_by_child("score").limit_to_first(5).get()

This query returns the first five users ordered by score.


When using order_by_key() to sort your data, data is returned in ascending order by key.

users_by_key = db.child("users").order_by_key().get()


When using order_by_value(), children are ordered by their value.

users_by_value = db.child("users").order_by_value().get()


The storage service allows you to upload images to Firebase.


Just like with the Database service, you can build paths to your data with the Storage service.



The put method takes the path to the local file and an optional user token.

storage =
# as admin
# as user
storage.child("images/example.jpg").put("example2.jpg", user['idToken'])


The download method takes the path to the saved database file and the name you want the downloaded file to have.



The get_url method takes the path to the saved database file and returns the storage url.


Helper Methods


db.generate_key() is an implementation of Firebase's key generation algorithm.

See multi-location updates for a potential use case.


Sometimes we might want to sort our data multiple times. For example, we might want to retrieve all articles written between a certain date then sort those articles based on the number of likes.

Currently the REST API only allows us to sort our data once, so the sort() method bridges this gap.

articles = db.child("articles").order_by_child("date").start_at(startDate).end_at(endDate).get()
articles_by_likes = db.sort(articles, "likes")

Common Errors

Index not defined

Indexing is not enabled for the database reference.

This project is forked from

Project details

Download files

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

Files for pyfireconnect, version 1.0.3
Filename, size File type Python version Upload date Hashes
Filename, size pyfireconnect-1.0.3.tar.gz (16.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page