Skip to main content

Dynamo Python Bindings

Python bindings for the Dynamo runtime system, enabling distributed computing capabilities for machine learning workloads.

🚀 Quick Start

  1. Install uv: https://docs.astral.sh/uv/#getting-started
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Install protoc protobuf compiler: https://grpc.io/docs/protoc-installation/.

For example on an Ubuntu/Debian system:

apt install protobuf-compiler
  1. Setup a virtualenv
uv venv
source .venv/bin/activate
uv pip install 'maturin[patchelf]'
  1. Build and install dynamo wheel
maturin develop --uv

Run Examples

Prerequisite

See README.md.

Hello World Example

  1. Start 3 separate shells, and activate the virtual environment in each
source .venv/bin/activate
  1. In one shell (shell 1), run example server the instance-1
python3 ./examples/hello_world/server.py
  1. (Optional) In another shell (shell 2), run example the server instance-2
python3 ./examples/hello_world/server.py
  1. In the last shell (shell 3), run the example client:
python3 ./examples/hello_world/client.py

If you run the example client in rapid succession, and you started more than one server instance above, you should see the requests from the client being distributed across the server instances in each server's output. If only one server instance is started, you should see the requests go to that server each time.

Performance

The performance impacts of synchronizing the Python and Rust async runtimes is a critical consideration when optimizing the performance of a highly concurrent and parallel distributed system.

The Python GIL is a global critical section and is ultimately the death of parallelism. To compound that, when Rust async futures become ready, accessing the GIL on those async event loop needs to be considered carefully. Under high load, accessing the GIL or performing CPU intensive tasks on on the event loop threads can starve out other async tasks for CPU resources. However, performing a tokio::task::spawn_blocking is not without overheads as well.

If bouncing many small message back-and-forth between the Python and Rust event loops where Rust requires GIL access, this is pattern where moving the code from Python to Rust will give you significant gains.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

ai_dynamo_runtime-1.4.1-cp310-abi3-manylinux_2_28_x86_64.whl (56.3 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.28+ x86-64

ai_dynamo_runtime-1.4.1-cp310-abi3-manylinux_2_28_aarch64.whl (55.7 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.28+ ARM64

File details

Details for the file ai_dynamo_runtime-1.4.1-cp310-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for ai_dynamo_runtime-1.4.1-cp310-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 b0e21e40c593df1906b20bf204456d7cad98d3ec5f099770cadc04b32f85e240
MD5 9eff68926a4bab669d06cf88e7f5d889
BLAKE2b-256 95951f99c494962aea9c1e76167a445a94cd2d85204a8cb37aa2ffdea35bc971

See more details on using hashes here.

File details

Details for the file ai_dynamo_runtime-1.4.1-cp310-abi3-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for ai_dynamo_runtime-1.4.1-cp310-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 1a5e6e3f5c212da5618a967150132ee0bca41d3f9f0c472a60ddd3104225ba46
MD5 f2758639fbcc1efd496032dbbe8e9a61
BLAKE2b-256 22c673858a35fd1482ed89e96a324e858a30a987e4ed763d87be4440def0bc70

See more details on using hashes here.

Release history Release notifications | RSS feed

1.4.2

2 files

This release

1.4.1 This release

2 files

1.4.0

2 files

1.3.1

2 files

1.3.0.post1

2 files

1.3.0

2 files

1.2.1

2 files

1.2.0.post1

2 files

1.1.1

2 files

1.1.0

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

0.9.1

2 files

0.9.0

2 files

0.8.1.post3

2 files

0.8.1.post2

2 files

0.8.1.post1

2 files

0.8.1

2 files

0.8.0

2 files

0.7.1

2 files

0.7.0.post1

2 files

0.7.0

2 files

0.6.1

2 files

0.6.0

3 files

0.5.1

3 files

0.5.0

3 files

0.4.1

3 files

0.4.0.post0

3 files

0.4.0

3 files

0.3.2

3 files

0.3.1

3 files

0.3.0

3 files

0.2.1

3 files

0.2.0

3 files

0.1.1

3 files

0.1.0

3 files

0.0.0.dev0

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page