ray.get_actor(name: str, namespace: str | None = None) ActorHandle[source]#

Get a handle to a named actor.

Gets a handle to an actor with the given name. The actor must have been created with Actor.options(name=”name”).remote(). This works for both detached & non-detached actors.

This method is a sync call and it’ll timeout after 60s. This can be modified by setting OS env RAY_gcs_server_request_timeout_seconds before starting the cluster.

  • name – The name of the actor.

  • namespace – The namespace of the actor, or None to specify the current namespace.


ActorHandle to the actor.


ValueError – if the named actor does not exist.