goakt

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 372 Open GitHub ↗

[Go]Distributed Actor/Grain framework for Golang with goodies

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h2 align="center">
  <img src="docs/assets/goakt-messaging-distributed-go.jpg" alt="GoAkt - Distributed Actor framework for Go" width="640"/><br />
  Distributed Actor framework for Go
</h2>

GoAkt is a distributed actor framework for [Go](https://go.dev/), inspired by Erlang and Akka. In development since 2022 and used [in production](#in-production), it lets you build responsive, resilient, and elastic systems with typed actor messages, running as a single process or a cluster of nodes behind the same API.

- **Simpler concurrency.** Actors process one message at a time; you write plain Go with no locks, channel plumbing, or shared-state bugs.
- **Location transparency.** Send a message to a local, remote, or clustered actor with the same API; the framework handles the wire.
- **Resilience by design.** Supervision trees and the "let it crash" model, inspired by Erlang/OTP, keep failures contained and recoverable.
- **Production batteries included.** Clustering, virtual actors (grains), CRDTs, streams, scheduling, passivation, and observability, without re-rolling them yourself.

Teams use GoAkt for event processing, IoT and edge workloads, real-time platforms, and distributed backends that would otherwise need a message broker plus custom coordination code.

New to the actor model? Actors are isolated units of computation that share no memory, each with a mailbox, private state, and one message in flight at a time. On a message, an actor can create more actors, send messages, or change how it handles the next one. For more depth, watch **Carl Hewitt**, the father of the actor model, explain it in his own words:

[![Carl Hewitt on the actor model](https://img.youtube.com/vi/7erJ1DV_Tlo/hqdefault.jpg)](https://www.youtube.com/watch?v=7erJ1DV_Tlo)

See the [documentation](https://docs.goakt.dev) for the full feature reference.

## Installation

```bash
go get github.com/tochemey/goakt/v4
```

## Examples

See the [examples repository](https://github.com/Tochemey/goakt-examples) for runnable code covering local, remote, and clustered actor systems.

## In Production

This framework is used in production by the following projects/companies:

- [Baki Money](https://www.baki.money/): AI-powered expense tracking platform that turns receipts into stories.
- [Event Processor](https://www.v-app.io/iot-builder-3/): Clustered Complex Event Processor (CEP) for IoT data streams.

## Security

Applications using this library should routinely upgrade their **Go version** and refresh **dependencies** as needed to mitigate security vulnerabilities. **GoAkt** will make a best effort to keep dependencies current and perform vulnerability checks whenever necessary. To report a vulnerability, use GitHub's [Report a Vulnerability](https://github.com/Tochemey/goakt/security/advisories/new) form, as described in [SECURITY.md](./SECURITY.md).

## Community

Ask questions and follow the work in [Discussions](https://github.com/Tochemey/goakt/discussions), [Issues](https://github.com/Tochemey/goakt/issues), or on [Slack](https://join.slack.com/t/oss-r2l2029/shared_invite/zt-42zcqua8y-unSUH0tFlOQzwT_smzYfOQ). Feedback on the [tracking issue](https://github.com/Tochemey/goakt/issues/948) helps shape what we work on next.

## Contribution

We welcome contributions: bug fixes, new features, and documentation improvements. Before diving in, read the [Architecture Document](./architecture/ARCHITECTURE.md) to understand the codebase. We use [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) and a Docker-backed `Makefile` so contributors only need Docker and Make installed; run `make help` to see the available targets.

See [contributing.md](./CONTRIBUTING.md) for prerequisites, setup, and the full contribution workflow, the other [design documents](./architecture/) covering the dispatcher pool, CRDTs, streams, reentrancy, and reliable delivery, and the [benchmark suite](./benchmark/) for the performance harness.

## Sponsors

GoAkt is free and open source. If you need priority support on complex topics or want to fund new features, consider [sponsorship](https://github.com/sponsors/Tochemey).

<a href="https://github.com/andrew-werdna"><img src="https:&#x2F;&#x2F;github.com&#x2F;andrew-werdna.png" width="60px" alt="User avatar: Andrew Brown" /></a><a href="https://github.com/StringKe"><img src="https:&#x2F;&#x2F;github.com&#x2F;StringKe.png" width="60px" alt="User avatar: StringKe" /></a>

goakt

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README