Installation

PyMediate is published on PyPI and installs with any Python package manager.

Requirements

Python 3.12 or higher — PyMediate uses PEP 695 type parameter syntax.
No required dependencies. The core is pure Python.
Optionally, dependency-injector>=4.41.0 for DI container integration (installed via the di extra).

Install the core package

pip install pymediate

uv add pymediate

poetry add pymediate

Install with dependency injection support

The di extra adds the dependency-injector integration:

pip install 'pymediate[di]'

uv add 'pymediate[di]'

poetry add 'pymediate[di]'

DependencyInjectorServiceProvider only imports successfully when dependency-injector is installed. Without the di extra, from pymediate.providers import DependencyInjectorServiceProvider raises ModuleNotFoundError. See troubleshooting if you hit this.

Verify the install

import pymediate

print(pymediate.__version__)

Development install

To contribute to PyMediate or run its test suite:

git clone https://github.com/sina-al/pymediate.git
cd pymediate

# Install with all extras and dev dependencies using uv
uv sync --all-extras

# Or in editable mode with pip
pip install -e '.[di,dev]'

Next steps

Head to the quick start to send your first request.