Skip to main content

Durable Actors for Python

Durable actors and typed clients, backed by the Rust runtime.

Quickstart · Reference · Runnable example

Quickstart

Requires Node.js 22.19+, pnpm, Python 3.11+, and uv.

pnpm dlx durable-actors init my-actors --template python
cd my-actors
pnpm install
uv sync

Define src/actors.py. Annotated fields persist; emitted() also broadcasts saved changes.

from durable_actors import Actor, emitted

class Counter(Actor):
    count: int = emitted(0)

    def increment(self, amount: int = 1) -> int:
        self.count += amount
        return self.count
pnpm exec durable-actors dev

Call an actor

In another terminal in the same directory, generate the client:

pnpm exec durable-actors generate

Save as client.py and run uv run client.py:

from generated import actors

counter = actors.Counter.get("one")
print(counter.increment())

Subscribe to state

Callbacks receive complete typed snapshots on a background thread. Keep the process running while listening; the context manager closes the subscription.

from generated import actors

counter = actors.Counter.get("one")
with counter.subscribe(lambda state: print(state.count), on_error=print):
    counter.increment()
    input("Press Enter to stop.\n")

Metadata

Release files for durable-actors 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for durable-actors 0.6.0
File Size Uploaded
durable_actors-0.6.0.tar.gz 135.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for durable-actors 0.6.0
File Interpreter ABI Platform
durable_actors-0.6.0-py3-none-any.whl Python 3 none any Details

Total release size: 186.3 kB

Release files / durable_actors-0.6.0.tar.gz

Download URL durable_actors-0.6.0.tar.gz
Size 135.3 kB
Tags Source
SHA-256 checksum
How to use checksums
d1fb21d36a5ad202a1202b6f5575f1a9fce22fc9ce684298748d23266a010a42
BLAKE2b-256 checksum
How to use checksums
1355fdddf3c97f6b1cae401579ad3ae21e3f7b4ae2c563c06b02341a6702bf54
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 29, 2026.

Transparency log

Release files / durable_actors-0.6.0-py3-none-any.whl

Download URL durable_actors-0.6.0-py3-none-any.whl
Size 51.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ee5a90c24f775dbc3a368620df993eacb67c8ae21aefaea63f4bc8ec535b7bfe
BLAKE2b-256 checksum
How to use checksums
d41583125096b5c2dbec0e522dcd95bab0e4573d847d102811c9c3ca69296711
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 29, 2026.

Transparency log

Release history Release notifications | RSS feed

0.7.9

2 release files

0.7.8

2 release files

0.7.7

2 release files

0.7.6

2 release files

0.7.5

2 release files

0.7.4

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.1

2 release files

This release

0.6.0 This release

2 release files

0.5.5

2 release files

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