Flask-SQLAlchemy is an extension for Flask that adds support for SQLAlchemy to your application. It aims to simplify using SQLAlchemy with Flask by providing useful defaults and extra helpers that make it easier to accomplish common tasks.

Install and update using pip:

$ pip install -U Flask-SQLAlchemy

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
app.config["SQLALCHEMY_DATABASE_URI"] = "sqlite:///example.sqlite"
db = SQLAlchemy(app)


class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String, unique=True, nullable=False)
    email = db.Column(db.String, unique=True, nullable=False)


db.session.add(User(username="Flask", email="example@example.com"))
db.session.commit()

users = User.query.all()

For guidance on setting up a development environment and how to make a contribution to Flask-SQLAlchemy, see the contributing guidelines.

The Pallets organization develops and supports Flask-SQLAlchemy and other popular packages. In order to grow the community of contributors and users, and allow the maintainers to devote more time to the projects, please donate today.

• Documentation: https://flask-sqlalchemy.palletsprojects.com/
• Changes: https://flask-sqlalchemy.palletsprojects.com/changes/
• PyPI Releases: https://pypi.org/project/Flask-SQLAlchemy/
• Source Code: https://github.com/pallets/flask-sqlalchemy/
• Issue Tracker: https://github.com/pallets/flask-sqlalchemy/issues/
• Website: https://palletsprojects.com/
• Twitter: https://twitter.com/PalletsTeam
• Chat: https://discord.gg/pallets