# Beanie

Asynchronous Python object-document mapper (ODM) for MongoDB.


Source: https://findsoftware.frbit.cloud/beanie/
Last reviewed: 2026-11-04
Listed since: 2026-11-04

## Record

### Links

- home: https://beanie-odm.dev/
- repository: https://github.com/BeanieODM/beanie
- docs: https://beanie-odm.dev/
- discord: https://discord.gg/AwwTrbCASP

### Identity

- status: active
- maintainer: Roman Right
- maintainerType: unknown
- parent: unknown
- firstRelease: 2021
- hqCountry: unknown

### Kind

- category: library
- hosting: python
- language: python
- runtime: python
- runtimeMin: python 3.10
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: mongodb
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: not applicable
- renderingModes: not applicable
- installMethod: pip install beanie

### License

- licenseModel: open-source
- license: Apache-2.0

### Releases

- currentMajor: 2
- latestReleaseDate: 2026-08-31

### Adoption

- githubStargazers: 2709
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 127
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 298
- dependentPackages: 36

### Sources

- urls: https://beanie-odm.dev/ (read 2026-11-04)
- urls: https://api.github.com/repos/BeanieODM/beanie (read 2026-11-04)
- urls: https://github.com/BeanieODM/beanie/blob/main/README.md (read 2026-11-04)
- firstRelease: https://pypi.org/pypi/beanie/json (read 2026-11-04)
- maintainer: https://github.com/BeanieODM/beanie/blob/2.2.0/pyproject.toml (read 2026-11-04)
- language: https://api.github.com/repos/BeanieODM/beanie (read 2026-11-04)
- runtime: https://github.com/BeanieODM/beanie/blob/2.2.0/pyproject.toml (read 2026-11-04)
- runtimeMin: https://github.com/BeanieODM/beanie/blob/2.2.0/pyproject.toml (read 2026-11-04)
- category: https://beanie-odm.dev/ (read 2026-11-04)
- databases: https://beanie-odm.dev/ (read 2026-11-04)
- installMethod: https://github.com/BeanieODM/beanie/blob/main/README.md (read 2026-11-04)
- installMethod: https://github.com/BeanieODM/beanie/blob/main/README.md (read 2026-11-04)
- license: https://api.github.com/repos/BeanieODM/beanie (read 2026-11-04)
- currentMajor: https://api.github.com/repos/BeanieODM/beanie/releases (read 2026-11-04)
- latestReleaseDate: https://api.github.com/repos/BeanieODM/beanie/releases/latest (read 2026-11-04)
- githubStargazers: https://api.github.com/repos/BeanieODM/beanie (read 2026-11-04)
- contributors: https://api.github.com/repos/BeanieODM/beanie/contributors (read 2026-11-04)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/beanie (read 2026-11-04)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/beanie (read 2026-11-04)

## Notes

Beanie is an asynchronous object-document mapper (ODM) for MongoDB, written in Python. Its data models are based on Pydantic, which the README and the homepage both name. The documentation site at beanie-odm.dev holds the tutorial, the API documentation and the development guidelines, and the project runs a Discord server for questions and discussion. The README names Bunnet as a synchronous version of the ODM, which is a separate project.

## Worth knowing

The README says a major release, Beanie v3, is in progress and has most of the maintainers' attention, so responses to pull requests and issues may be slower than usual.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0