beanie

Overview

Beanie - is an asynchronous Python object-document mapper (ODM) for MongoDB. Data models are based on Pydantic.

When using Beanie each database collection has a corresponding Document that is used to interact with that collection. In addition to retrieving data, Beanie allows you to add, update, or delete documents from the collection as well.

Beanie saves you time by removing boilerplate code, and it helps you focus on the parts of your app that actually matter.

Data and schema migrations are supported by Beanie out of the box.

There is a synchronous version of Beanie ODM - Bunnet

Installation

PIP

pip install beanie

Poetry

poetry add beanie

For more installation options (eg: aws, gcp, srv ...) you can look in the getting started

Example

…

Links

Documentation

• Doc - Tutorial, API documentation, and development guidelines.

Example Projects

• Activity Log & Notification Service - Real-time event ingestion with FastAPI, Beanie ODM, and DocumentDB (MongoDB-compatible), an async backend for high-volume activity events with aggregation statistics and WebSocket alerts by Khelan Modi
• fastapi-beanie-jwt - Sample FastAPI server with JWT auth and Beanie ODM by Michael duPont
• fastapi-cosmos-beanie - FastAPI + Beanie ODM + Azure Cosmos Demo Application by Anthony Shaw
• LCCN Predictor - Leetcode contest rating predictor (FastAPI + Beanie ODM + React) by L. Bao
• Shortify - URL shortener RESTful API (FastAPI + Beanie ODM + JWT & OAuth2) by Iliya Hosseini

Articles

• Announcing Beanie - MongoDB ODM
• Build a Cocktail API with Beanie and MongoDB
• MongoDB indexes with Beanie
• Beanie Projections. Reducing network and database load.
• Beanie 1.0 - Query Builder
• Beanie 1.8 - Relations, Cache, Actions and more!

Resources

• GitHub - GitHub page of the project
• Changelog - list of all the valuable changes
• Discord - ask your questions, share ideas or just say Hello!!