{"library":"beanie","type":"library","category":null,"description":"Async Python ODM for MongoDB built on Pydantic. Current version: 2.0.1 (Nov 2025). v2.0 breaking change: dropped Motor in favor of pymongo AsyncMongoClient. Requires Pydantic v2. Inner class Collection removed — use Settings instead. Must call init_beanie() before any document operations. Sync version is Bunnet (separate package).","language":"python","status":"active","version":"2.0.1","tags":["beanie","mongodb","odm","async","pydantic","fastapi","python"],"last_verified":"Tue Jun 09","install":[{"cmd":"pip install beanie","imports":["from pymongo import AsyncMongoClient\nfrom beanie import Document, Indexed, init_beanie\nfrom pydantic import BaseModel\nfrom typing import Optional\n\nclass Category(BaseModel):\n    name: str\n\nclass Product(Document):\n    name: str\n    price: Indexed(float)\n    category: Optional[Category] = None\n\n    class Settings:  # v2 style — not Collection\n        name = 'products'\n\nasync def init():\n    client = AsyncMongoClient('mongodb://localhost:27017')\n    await init_beanie(\n        database=client.mydb,\n        document_models=[Product]\n    )","# All operations require init_beanie() to have been called first\n\n# Create\nproduct = await Product(name='Widget', price=9.99).insert()\n# or:\nproduct = await Product.insert_one(Product(name='Widget', price=9.99))\n\n# Find\nproducts = await Product.find(Product.price < 10.0).to_list()\nproduct = await Product.find_one(Product.name == 'Widget')\nproduct = await Product.get(product_id)  # by _id\n\n# Update\nawait product.set({Product.price: 12.99})\n# or:\nproduct.price = 12.99\nawait product.save()\n\n# Delete\nawait product.delete()"]}],"homepage":"https://beanie-odm.dev","github":"https://github.com/BeanieODM/beanie","docs":null,"changelog":null,"pypi":"https://pypi.org/project/beanie/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"compatibility":{"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":4.6,"avg_import_s":0.41,"wheel_type":"wheel"},"url":"https://checklist.day/v1/registry/beanie/compatibility"}}