BeanieODM/beanie

Health v2 · maintenance only

Adoption not part of the score

2695 stars · 306 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Beanie is an asynchronous Python object-document mapper (ODM) for MongoDB, with data models built on Pydantic. Each MongoDB collection maps to a Document class supporting CRUD, pythonic queries, aggregations, indexes, and built-in data and schema migrations.

Use cases

• map MongoDB collections to typed Pydantic models in Python
• query MongoDB with pythonic expressions like Product.price < 10
• run async MongoDB CRUD in FastAPI or asyncio apps
• manage MongoDB schema and data migrations
• define indexes declaratively on document fields
• build aggregation pipelines with typed projections

When to choose

• you use MongoDB with async Python (e.g. FastAPI) and want Pydantic-based models
• you want an ODM with migrations, indexes, and relations out of the box
• you prefer typed, pythonic query syntax over raw pymongo dicts

When to avoid

• you need a synchronous ODM (use Bunnet instead)
• you use a relational database or SQL-based ORM
• you rely on Pydantic v1 or very old MongoDB/Python versions

Facets

library · maturity active

orm database-driver database databases backend web-development developer-tools python cross-platform mongodb odm pydantic asyncio motor pymongo schema-migrations

Member repositories

For agents

markdown · JSON · MCP: product_card(name="BeanieODM/beanie")