https://github.com/resonatehq/resonate

a dead simple programming model for the cloud
https://github.com/resonatehq/resonate

async-await dead-simple deterministic-simulation distributed-systems golang promise resonate

Last synced: 12 days ago
JSON representation

a dead simple programming model for the cloud

• Host: GitHub
• URL: https://github.com/resonatehq/resonate
• Owner: resonatehq
• License: apache-2.0
• Created: 2023-08-09T19:07:14.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-05-22T20:27:14.000Z (11 months ago)
• Last Synced: 2024-05-22T21:35:21.360Z (11 months ago)
• Topics: async-await, dead-simple, deterministic-simulation, distributed-systems, golang, promise, resonate
• Language: Go
• Homepage: https://www.resonatehq.io
• Size: 1.7 MB
• Stars: 257
• Watchers: 10
• Forks: 22
• Open Issues: 30
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        


    



Resonate




[![ci](https://github.com/resonatehq/resonate/actions/workflows/cicd.yaml/badge.svg)](https://github.com/resonatehq/resonate/actions/workflows/cicd.yaml)

[![dst](https://github.com/resonatehq/resonate/actions/workflows/dst.yaml/badge.svg)](https://github.com/resonatehq/resonate/actions/workflows/dst.yaml)

[![Go Report Card](https://goreportcard.com/badge/github.com/resonatehq/resonate)](https://goreportcard.com/report/github.com/resonatehq/resonate)

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)





Docs

    •  

  Twitter

    •  

  Discord

    •  

  Issues

    •  

  Roadmap

  




## Distributed Async Await

Resonate's Distributed Async Await is a new programming model that simplifies coding for the cloud. It ensures code completion even if hardware or software failures occur during execution. The programming model does this with just functions and promises, making it trivial to build `coordinated` and `reliable` distributed applications.

## Why Resonate?

- **Cloud Computing Made Dead Simple**: Resonate simplifies coding for the cloud using an intuitive paradigm you already know — async await.

- **Single Binary**: Resonate simplifies your deployment and operations with a single binary.

- **Incremental Adoption and No Vendor Lock-In**: Resonate was designed to allow for incremental adoption without vendor lock-in ever.

- **Built on an Open Standard**: Resonate's programming model is built on top of [durable promises](https://github.com/resonatehq/durable-promise-specification), an open standard with an intentionally minimal API surface area.

## Install

```

brew install resonatehq/tap/resonate

```

You can also [download the latest release](https://github.com/resonatehq/resonate/releases/latest).

## Getting Started

1. [Start building in just 30 seconds](https://docs.resonatehq.io/getting-started/quickstart) with our quickstart guide!

2. [Grasp the 4 core concepts](https://docs.resonatehq.io/getting-started/concepts) of distributed async/await applications by delving into our concepts page.

3. [Dive into the Resonate Server docs](https://docs.resonatehq.io/resonate/overview) and learn how to configure, deploy, and more.

## SDKs

Resonate provides client SDKs for different programming languages to easily interact with the Resonate server and write elegant distributed async await applications. More are coming soon!

| Type   | Language                                                                                                            | Source Code                                   | Package                                              |

| ------ | :-----------------------------------------------------------------------------------------------------------------: | --------------------------------------------- | ---------------------------------------------------- |

| py     |    | https://github.com/resonatehq/resonate-sdk-py | [pypi](https://pypi.org/project/resonate-sdk/)       |

| ts     |  | https://github.com/resonatehq/resonate-sdk-ts | [npm](https://www.npmjs.com/package/@resonatehq/sdk) |

## Core Features

The basic features Resonate offers to simplify the reliability and coordination of distributed processes are the following:

- **Retries**: If a process fails while executing a durable promise due to a transient issue, such as network connectivity problems, it can be transparently retried, minimizing the impact of temporary failures.

- **Recoverability**: If a process crashes while executing a durable promise, it can recover and continue from where it left off, ensuring your application remains resilient.

- **Schedules**: Durable promises can be used to schedule stateful reminders using a simple HTTP/gRPC call.

- **Task Framework**: Durable promises allow you to fan out tasks across multiple processes or machines, enabling parallel execution and load balancing, making your application more scalable.

- **Notifications**: When a durable promise is created or completed, it can trigger notifications to other processes or services that are interested in the result, enabling efficient communication and coordination.

- **Human in the Loop**: Durable promises can seamlessly integrate human input into your automated workflows, allowing for manual intervention or approval steps when needed.

## Contributing

See our [contribution guidelines](CONTRIBUTING.md).

## License

The Resonate Server is available under the [Apache 2.0 License](LICENSE).