The documentation you are viewing is for Dapr v0.11 which is an older version of Dapr. For up-to-date documentation, see the latest version.
Getting started with the Dapr actor Python SDK
The Dapr actor package allows you to interact with Dapr virtual actors from a Python application.
- Dapr CLI installed
- Initialized Dapr environment
- Python 3.7+ installed
- Dapr Python module installed
The interface defines the actor contract that is shared between the actor implementation and the clients calling the actor. Because a client may depend on it, it typically makes sense to define it in an assembly that is separate from the actor implementation.
from dapr.actor import ActorInterface, actormethod class DemoActorInterface(ActorInterface): @actormethod(name="GetMyData") async def get_my_data(self) -> object: ...
An actor service hosts the virtual actor. It is implemented a class that derives from the base type
Actor and implements the interfaces defined in the actor interface.
Actors can be created using one of the Dapr actor extensions:
An actor client contains the implementation of the actor client which calls the actor methods defined in the actor interface.
import asyncio from dapr.actor import ActorProxy, ActorId from demo_actor_interface import DemoActorInterface async def main(): # Create proxy client proxy = ActorProxy.create('DemoActor', ActorId('1'), DemoActorInterface) # Call method on client resp = await proxy.GetMyData()
Visit this page for a runnable actor sample.