A simple Docker HTTP API wrapper written with asyncio and aiohttp.
Installation
pip install aiodockerDevelopment
The recommended developer setup uses uv, which manages the virtualenv and resolves dependencies from the committed uv.lock so every contributor and CI job builds against the same versions.
# Install uv first: https://docs.astral.sh/uv/getting-started/installation/
uv sync --extra dev --extra lint --extra test --extra doc
uv run pre-commit installThe Makefile helpers (make develop, make install, make lint, make test) all assume uv.
Using pip instead (fallback)
If you can’t install uv, you can still bootstrap with pip. The resulting environment isn’t pinned to uv.lock, so versions may drift from CI.
python -m venv .venv && source .venv/bin/activate
pip install -U pip
pip install -e '.[dev,lint,test,doc]' # in zsh, you need to escape brackets
pre-commit installRunning tests
# Run all tests
make test
# Run individual tests
uv run pytest tests/test_images.pyBuilding packages
NOTE: Usually you don’t need to run this step by yourself.
uv buildDocumentation
Examples
import asyncio
import aiodocker
async def list_things(docker):
print('== Images ==')
for image in (await docker.images.list()):
tags = image['RepoTags'][0] if image['RepoTags'] else ''
print(image['Id'], tags)
print('== Containers ==')
for container in (await docker.containers.list()):
print(f" {container._id}")
async def run_container(docker):
print('== Running a hello-world container ==')
container = await docker.containers.create_or_replace(
config={
'Cmd': ['/bin/ash', '-c', 'echo "hello world"'],
'Image': 'alpine:latest',
},
name='testing',
)
await container.start()
logs = await container.log(stdout=True)
print(''.join(logs))
await container.delete(force=True)
async def main():
docker = aiodocker.Docker()
await list_things(docker)
await run_container(docker)
await docker.close()
if __name__ == "__main__":
asyncio.run(main())5 maintainers
Release files for aiodocker 0.27.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aiodocker-0.27.0.tar.gz | 328.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aiodocker-0.27.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 383.2 kB
Release files / aiodocker-0.27.0.tar.gz
| Download URL | aiodocker-0.27.0.tar.gz |
|---|---|
| Size | 328.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
74586f4929aee4563ee7db50996a1a39ac35e06c80701daad31f94aadb6551c7
|
|
BLAKE2b-256 checksum How to use checksums |
a819f07d8532d7489ed8629847d004d0bbd286287286a76828be43aca7e6b106
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 27, 2026.
Transparency logRelease files / aiodocker-0.27.0-py3-none-any.whl
| Download URL | aiodocker-0.27.0-py3-none-any.whl |
|---|---|
| Size | 55.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c55647bdcaf546dd4fc9b52794a9510575e126888dff478a9185f580a40dc45e
|
|
BLAKE2b-256 checksum How to use checksums |
de54cd3aa680c9653b8708e164d610948e7a9aa50bba619705ac6169f61b0837
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 27, 2026.
Transparency log
