Installation¶

aiomoto is published on PyPI:

pip install aiomoto

It requires Python 3.11 or newer and pulls in aiobotocore, moto, and platformdirs.

Service extras¶

aiomoto re-exposes Moto's service extras, so you can install Moto plus the dependencies required for the specific AWS services you use:

pip install "aiomoto[s3]"

pip install "aiomoto[dynamodb]"

pip install "aiomoto[all]"

Moto's extras are service selectors for dependency sets (use all if you want everything) rather than features provided by aiomoto itself. See the Moto install guide for the full list.

Server mode¶

Server mode runs a local Moto server instead of patching in process. It needs Moto's server extra:

pip install "aiomoto[server]"

Pandas and Polars¶

These integrations bundle everything needed for s3:// DataFrame I/O, which always runs through server mode:

pip install "aiomoto[pandas]"

pip install "aiomoto[polars]"

See Pandas and Polars for how s3:// paths are routed through Moto.

Verify the install¶

import aiomoto

print(aiomoto.__version__)

Continue to the Quick start to mock your first AWS service.