Akka 1.5.57-beta2

Akka.NET

Akka.NET logo

Discord NuGet Nuget

Akka.NET is a .NET port of the popular Akka project from the Scala / Java community. We are an idiomatic .NET implementation of the actor model built on top of the .NET Common Language Runtime.

Akka.NET is a .NET Foundation project.

.NET Foundation Logo

How is Akka.NET Used?

Akka.NET can be used in-process or inside large, distributed real-time systems; we support a wide variety of use cases.

Akka.NET can be used to solve the following types of problems:

  1. Concurrency - Akka.NET actors only process messages one-at-a-time and they do so in first in, first out (FIFO) order; this means that any application state internal to an actor is automatically thread-safe without having to use locks or any other shared-memory synchronization mechanisms.
  2. Stream Processing - Akka.NET actors and Akka.Streams make it easy to build streaming applications, used for processing incoming streams of data or incoming streams of live events such as UI or network events inside native applications.
  3. Event-Driven Programming - actors make it easy to build event-driven applications, as actors' message-processing routines naturally express these types of designs.
  4. Event Sourcing and CQRS - Akka.Persistence, used by actors to make their state re-entrant and recoverable across restarts or migrations between nodes, natively supports event sourcing. Akka.Persistence.Query can be used to compute CQRS-style projections and materialized views from Akka.Persistence data.
  5. Location Transparency - Akka.Remote makes it simple for actors in remote processes to transparently communicate with each other.
  6. Highly Available, Fault-Tolerant Distributed Systems - Akka.Cluster, Akka.Cluster.Sharding, and other tools built on top of Akka.Cluster make it possible to build highly available and fault-tolerant distributed systems by leveraging peer-to-peer programming models with topology-aware message routing and distribution.
  7. Low Latency, High Throughput - Akka.NET aims to be low latency and high throughput, processing 10s millions of messages per second in-memory and hundreds of thousands of messages per second over remote connections.

Where Can I Learn Akka.NET?

You can start by taking the Akka.NET Bootcamp, but there are many other great learning resources for Akka.NET Online.

Build Status

Stage Status
NuGet Pack Build Status
.NET Framework Unit Tests Build Status
.NET Unit Tests (Windows) Build Status
.NET Unit Tests (Linux) Build Status
.NET MultiNode Tests (Windows) Build Status
.NET MultiNode Tests (Linux) Build Status
Docs Build Status

Install Akka.NET via NuGet

If you want to include Akka.NET in your project, you can install it directly from NuGet

To install Akka.NET Distributed Actor Framework, run the following command in the Package Manager Console

PM> Install-Package Akka.Hosting

Akka.Hosting includes the base Akka NuGet package and also provides an easy interface to integrate Akka.NET with the most-used parts of the Microsoft.Extensions ecosystem: Configuration, Logging, Hosting, and DependencyInjection. We encourage developers to adopt it.

And if you need F# support:

PM> Install-Package Akka.FSharp

Akka.NET Project Templates

To create your own Akka.NET projects using our templates (Akka.Templates), install them via the dotnet CLI:

dotnet new install "Akka.Templates::*"

This will make our templates available via dotnet new on the CLI and as new project templates inside any .NET IDE such as Visual Studio or JetBrains Rider. You can view the full list of templates included in our package here: https://github.com/akkadotnet/akkadotnet-templates#available-templates

Builds

Please see Building Akka.NET.

To access nightly Akka.NET builds, please see the instructions here.

Support

If you need help getting started with Akka.NET, there's a number of great community resources online:

If you and your company are interested in getting professional Akka.NET support, you can contact Petabridge for dedicated Akka.NET support.

No packages depend on Akka.

Akka.NET v1.5.57-beta2 is a beta release containing significant new APIs for Akka.Persistence that add completion callbacks and async handler support.

New Features:

  • Persistence completion callbacks via Defer - simplified alternative - This release adds completion callback and async handler support to Persist, PersistAsync, PersistAll, and PersistAllAsync methods in Akka.Persistence. Key improvements include:
    • Async Handler Support: All persist methods now support Func<TEvent, Task> handlers for async event processing
    • Completion Callbacks: PersistAll and PersistAllAsync now accept optional completion callbacks (both sync Action and async Func<Task>) that execute after all events are persisted and handled
    • Ordering Guarantees: Completion callbacks use Defer/DeferAsync internally to maintain strict ordering guarantees
    • Zero Breaking Changes: All new APIs are additive overloads

Code Examples:

// Async handler support - process events asynchronously
Persist(new OrderPlaced(orderId), async evt =>
{
    await _orderService.ProcessOrderAsync(evt);
});

// PersistAll with completion callback - know when all events are done
PersistAll(orderEvents, evt =>
{
    _state.Apply(evt);
}, onComplete: () =>
{
    // All events persisted and handlers executed
    _logger.Info("Order batch completed");
    Sender.Tell(new BatchComplete());
});

// PersistAll with async handler AND async completion callback
PersistAll(events,
    handler: async evt => await ProcessEventAsync(evt),
    onCompleteAsync: async () =>
    {
        await NotifyCompletionAsync();
        Sender.Tell(Done.Instance);
    });

// PersistAllAsync with completion - allows commands between handlers
PersistAllAsync(largeEventBatch,
    handler: evt => _state.Apply(evt),
    onComplete: () => Sender.Tell(new BatchProcessed()));

Technical Details:

The implementation maintains Akka.Persistence's strict ordering guarantees by using Defer/DeferAsync for completion callbacks, ensuring they execute in order even when called with empty event collections. The new async handler invocations (IAsyncHandlerInvocation) are processed via RunTask to preserve the actor's single-threaded execution model.

1 contributor since release 1.5.57-beta1

COMMITS LOC+ LOC- AUTHOR
1 1386 67 Aaron Stannard

To see the full set of changes in Akka.NET v1.5.57-beta2, click here

Version Downloads Last updated
1.5.57-beta2 2 12/4/2025
1.5.57-beta1 3 12/2/2025
1.5.56 8 11/26/2025
1.5.55 27 10/27/2025
1.5.54 38 10/23/2025
1.5.53 39 10/23/2025
1.5.52 33 10/23/2025
1.5.51 32 10/23/2025
1.5.50 28 10/23/2025
1.5.49 27 10/23/2025
1.5.48 30 10/23/2025
1.5.47 33 10/23/2025
1.5.46 37 10/23/2025
1.5.45 32 10/23/2025
1.5.44 34 10/23/2025
1.5.43 33 10/23/2025
1.5.42 24 10/23/2025
1.5.41 29 10/23/2025
1.5.40 34 10/23/2025
1.5.39 26 10/23/2025
1.5.38 39 10/23/2025
1.5.37 25 10/23/2025
1.5.36 35 10/23/2025
1.5.35 37 10/23/2025
1.5.34 38 10/23/2025
1.5.33 30 10/23/2025
1.5.32 28 10/23/2025
1.5.31 34 10/23/2025
1.5.30 32 10/23/2025
1.5.29 29 10/23/2025
1.5.28 31 10/23/2025
1.5.28-beta1 32 10/23/2025
1.5.27.1 35 10/23/2025
1.5.27 34 10/23/2025
1.5.27-beta2 25 10/23/2025
1.5.27-beta1 32 10/23/2025
1.5.26 36 10/23/2025
1.5.25 25 10/23/2025
1.5.24 22 10/23/2025
1.5.23 35 10/23/2025
1.5.22 26 10/23/2025
1.5.21 36 10/23/2025
1.5.20 34 10/23/2025
1.5.19 30 10/23/2025
1.5.18 32 10/23/2025
1.5.17.1 30 10/23/2025
1.5.17 35 10/23/2025
1.5.16 35 10/23/2025
1.5.15 36 10/23/2025
1.5.14 36 10/23/2025
1.5.13 37 10/23/2025
1.5.13-beta1 32 10/23/2025
1.5.12 31 10/23/2025
1.5.11 34 10/23/2025
1.5.10 29 10/23/2025
1.5.9 28 10/23/2025
1.5.8 34 10/23/2025
1.5.7 31 10/23/2025
1.5.6 29 10/23/2025
1.5.5 33 10/23/2025
1.5.4 32 10/23/2025
1.5.3 34 10/23/2025
1.5.2 31 10/23/2025
1.5.1 37 10/23/2025
1.5.0 29 10/23/2025
1.5.0-beta6 32 10/23/2025
1.5.0-beta5 34 10/23/2025
1.5.0-beta4 32 10/23/2025
1.5.0-beta3 31 10/23/2025
1.5.0-beta2 31 10/23/2025
1.5.0-beta1 31 10/23/2025
1.5.0-alpha4 32 10/23/2025
1.5.0-alpha3 32 10/23/2025
1.5.0-alpha2 35 10/23/2025
1.5.0-alpha1 30 10/23/2025
1.4.51 34 10/23/2025
1.4.50 30 10/23/2025
1.4.49 34 10/23/2025
1.4.49-beta1 36 10/23/2025
1.4.48 26 10/23/2025
1.4.47 35 10/23/2025
1.4.46 35 10/23/2025
1.4.45 27 10/23/2025
1.4.44 36 10/23/2025
1.4.43 31 10/23/2025
1.4.42 34 10/23/2025
1.4.41 28 10/23/2025
1.4.40 32 10/23/2025
1.4.39 32 10/23/2025
1.4.38 29 10/23/2025
1.4.37 31 10/23/2025
1.4.36 35 10/23/2025
1.4.35 31 10/23/2025
1.4.34 30 10/23/2025
1.4.33 29 10/23/2025
1.4.32 34 10/23/2025
1.4.31 36 10/23/2025
1.4.30 34 10/23/2025
1.4.29 36 10/23/2025
1.4.28 34 10/23/2025
1.4.27 31 10/23/2025
1.4.26 37 10/23/2025
1.4.25 34 10/23/2025
1.4.24 31 10/23/2025
1.4.23 35 10/23/2025
1.4.22 32 10/23/2025
1.4.21 32 10/23/2025
1.4.21-beta1 37 10/23/2025
1.4.20 34 10/23/2025
1.4.19 38 10/23/2025
1.4.18 37 10/23/2025
1.4.17 43 10/23/2025
1.4.16 39 10/23/2025
1.4.15 29 10/23/2025
1.4.14 23 10/23/2025
1.4.13 36 10/23/2025
1.4.12 37 10/23/2025
1.4.11 43 10/23/2025
1.4.10 35 10/23/2025
1.4.9 37 10/23/2025
1.4.8 28 10/23/2025
1.4.7 39 10/23/2025
1.4.6 34 10/23/2025
1.4.5 35 10/23/2025
1.4.4 27 10/23/2025
1.4.3 29 10/23/2025
1.4.2 36 10/23/2025
1.4.1 37 10/23/2025
1.4.1-rc3 41 10/23/2025
1.4.1-rc2 30 10/23/2025
1.4.1-rc1 35 10/23/2025
1.4.0 5 11/26/2025
1.4.0-beta4 32 10/23/2025
1.4.0-beta3 46 10/23/2025
1.4.0-beta2 29 10/23/2025
1.4.0-beta1 27 10/23/2025
1.3.19 28 10/23/2025
1.3.18 31 10/23/2025
1.3.17 31 10/23/2025
1.3.16 26 10/23/2025
1.3.15 31 10/23/2025
1.3.14 39 10/23/2025
1.3.13 31 10/23/2025
1.3.12 36 10/23/2025
1.3.11 36 10/23/2025
1.3.10 38 10/23/2025
1.3.9 37 10/23/2025
1.3.8 34 10/23/2025
1.3.7 24 10/23/2025
1.3.6 33 10/23/2025
1.3.5 31 10/23/2025
1.3.4 34 10/23/2025
1.3.3 31 10/23/2025
1.3.2 36 10/23/2025
1.3.1 31 10/23/2025
1.3.0 27 10/23/2025
1.2.3 33 10/23/2025
1.2.2 35 10/23/2025
1.2.1 34 10/23/2025
1.2.0 35 10/23/2025
1.1.3 40 10/23/2025
1.1.2 26 10/23/2025
1.1.1 35 10/23/2025
1.1.0 35 10/23/2025
1.0.8 35 10/23/2025
1.0.7 34 10/23/2025
1.0.6 37 10/23/2025
1.0.5 33 10/23/2025
1.0.4 29 10/23/2025
1.0.3 37 10/23/2025
1.0.2 32 10/23/2025
1.0.1 34 10/23/2025
1.0.0 29 10/23/2025
1.0.0-dev1504032244 22 10/23/2025
0.8.0 30 10/23/2025
0.7.1 40 10/23/2025
0.7.0 27 10/23/2025
0.6.4 36 10/23/2025
0.6.3 33 10/23/2025
0.6.2 39 10/23/2025
0.6.1 30 10/23/2025
0.6.0 30 10/23/2025
0.5.8 29 10/23/2025
0.5.2 34 10/23/2025
0.5.0 34 10/23/2025
0.2.1-beta 34 10/23/2025
0.2.0-beta 27 10/23/2025