Awesome Open Source
Awesome Open Source


Bibi is an e-commerce fullstack solution built with Flask. It includes e-commerce, social, and hot common modules. It stood the test of business operations, is a light but complete solution.

This project provides backend service, based on Flask, MongoDB, Redis, Celery, RabbitMQ, and supports Python 3.5.

Bibi offers fullstack solution for use with the following:

bibi-frontend Mobile web frontend

bibi-ionic Hybrid APP


  • [x] User

    • [x] Supports Email, Wechat, Weibo, QQ, and Facebook Oauth,social-oauth for details
    • [x] User Information, Address, Contact, Favor collections and etc..
  • [x] Social

    • [x] Post, like, comment, and bad information report.
    • [x] Following and followers.
    • [x] Notifications.
  • [x] Content

    • [x] Products board
    • [x] Banners
  • [x] Product

    • [x] Brands, categories, tags, vendors, price history.
    • [x] Commodities sub-selections based on different colors, sizes and materials.
  • [x] Cart

    • [x] Session carts
    • [x] Snapshot for items
  • [x] Order

    • [x] Snapshot for order, store items history
    • [x] Split into different packages depend on the total price and categories
    • [x] Logistics information tracking, automatic updates
    • [x] Third party logistics business parcel handling
  • [x] Payment

    • [x] Supports Wechat,Paypal and etc..
    • [x] Supports coupons, coins for discount.
  • [x] Management System

  • [x] AWS file upload

  • [x] Bing translate API

  • [x] Openexchange rate API

  • [x] Kuaidi100 logistics tracking API


Content Management Logistics Management Product Management

Get Started

This based on Ubuntu/Debian,please skip if you had set up Python 3 environment.

# set up python3 environment
sudo apt-get update
sudo apt-get install python3-pip python3-dev
sudo apt-get install build-essential libssl-dev libffi-dev python-dev

# set up virtualenv
sudo pip3 install virtualenv virtualenvwrapper
echo "export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3" >> ~/.bashrc
echo "export WORKON_HOME=~/Env" >> ~/.bashrc
echo "source /usr/local/bin/" >> ~/.bashrc
source ~/.bashrc

# Now virtual env for python3 will be installed in ~/Env

mkvirtualenv bibi # rename bibi
workon bibi # activate bibi env

# set up mongodb # 2.6 version
# set up redis
# set up rabbitMQ

mongod &              # start mongodb
redis-server &        # start redis
rabbitmq-server &     # start RabbitMQ

Install dependencies

pip3 install -r requirements.txt

Initial database

python3 shell
# into Python3 shell
>>> from application.models import User
>>> user = User.create(email="[email protected]", password="xxx", name="xxxx")
# Rename the email, password, name
>>> user.roles.append("ADMIN")

Run server

# start celery
celery -A application.cel worker -l info &

python3 runserver

Now open on local.


# set up supervisor
sudo apt-get install supervisor
# set up gunicorn
pip3 install gunicorn

Create supervisor config

sudo vim /etc/supervisor/conf.d/bibi.conf

    -w 3
    --log-level debug

directory=/opt/py-maybi/                                       ; Project dir
stdout_logfile=/opt/logs/gunicorn.log                          ; log dir

PS: -w the workers number,formula:(CPUs*2 + 1)

Create nginx config

sudo vim /etc/nginx/sites-enabled/bibi.conf

server {
    listen 80;

    location / {
        proxy_pass; # Pointing to the gunicorn host
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;


Start supervisor, nginx

sudo supervisorctl reload
sudo supervisorctl start bibi

sudo service nginx restart

Bravo! It's done.

Please open issues if you have problems.



Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,161,998
Python (894,636
Angular (55,138
Mongodb (32,192
Redis (24,312
Flask (21,478
Cart (5,033
Full Stack (3,920
Celery (2,599
Supervisor (2,212