How apache/pekko works
Apache Pekko is a framework for concurrent, distributed, resilient applications built around the Actor Model, with persistence, streams, HTTP, and other libraries. A principal runtime path is application code defining actor behavior and using an actor system to run it, then exchanging messages through actor references; the typed-delivery branch adds consumer-driven flow control and optional durable producer storage. The graph also preserves major documented library areas and representative runtime infrastructure. Evidence is limited to the README and sampled excerpts; unsampled subsystem links are omitted rather than inferred.
Main entry points: ProducerController.scala Producer Controller · actor/ActorSystem.scala Classic Actor System · Actor.scala Classic Actors · typed/ActorSystem.scala Typed Actor System
Components 17
Actor Runtime
- Classic Actor System
actor/src/main/scala/org/apache/pekko/actor/ActorSystem.scala - Classic Actors
actor/src/main/scala/org/apache/pekko/actor/Actor.scala - Typed Actor System
actor-typed/src/main/scala/org/apache/pekko/actor/typed/ActorSystem.scala - Typed Behaviors
actor-typed/src/main/scala/org/apache/pekko/actor/typed/scaladsl/Behaviors.scala - Typed Actor Ref
actor-typed/src/main/scala/org/apache/pekko/actor/typed/ActorRef.scala - Supervision
actor-typed/src/main/scala/org/apache/pekko/actor/typed/SupervisorStrategy.scala - Dispatching
actor/src/main/scala/org/apache/pekko/dispatch/Dispatcher.scala - Logging
actor/src/main/scala/org/apache/pekko/event/Logging.scala
Typed Delivery
- Producer Controller
actor-typed/src/main/scala/org/apache/pekko/actor/typed/delivery/ProducerController.scala - Producer Runtime
actor-typed/src/main/scala/org/apache/pekko/actor/typed/delivery/internal/ProducerControllerImpl.scala - Consumer Controller
actor-typed/src/main/scala/org/apache/pekko/actor/typed/delivery/ConsumerController.scala - Durable Queue API
actor-typed/src/main/scala/org/apache/pekko/actor/typed/delivery/DurableProducerQueue.scala
Cluster Coordination
- Cluster Singleton
cluster-tools/src/main/scala/org/apache/pekko/cluster/singleton/ClusterSingletonManager.scala
Application Libraries
- Persistence
persistence-typed/src/main/scala/org/apache/pekko/persistence/typed - Streams
stream/src/main/scala/org/apache/pekko/stream - HTTP
Other components
- Application
Connections 13
- Application → Classic Actor System: starts actors
actor/src/main/scala/org/apache/pekko/actor/ActorSystem.scala - Application → Typed Actor System: uses actor model
- Application → Typed Behaviors: defines behavior
- Classic Actor System → Classic Actors: creates actors
actor/src/main/scala/org/apache/pekko/actor/ActorSystem.scala - Application → Typed Actor Ref: sends messages
actor-typed/src/main/scala/org/apache/pekko/actor/typed/ActorRef.scala - Application → Producer Controller: uses delivery
actor-typed/src/main/scala/org/apache/pekko/actor/typed/delivery/ProducerController.scala - Producer Controller → Consumer Controller: coordinates demand
actor-typed/src/main/scala/org/apache/pekko/actor/typed/delivery/ProducerController.scala - Producer Controller → Durable Queue API: stores unconfirmed
actor-typed/src/main/scala/org/apache/pekko/actor/typed/delivery/ProducerController.scala - Producer Controller → Producer Runtime: implemented by
actor-typed/src/main/scala/org/apache/pekko/actor/typed/delivery/internal/ProducerControllerImpl.scala - Application → Cluster Singleton: uses coordination
- Application → Persistence: uses persistence
- Application → Streams: uses streams
- Application → HTTP: uses HTTP