base on Restate is the platform for building resilient applications that tolerate all infrastructure faults w/o the need for a PhD. [![Documentation](https://img.shields.io/badge/doc-reference-blue)](https://docs.restate.dev) [![Examples](https://img.shields.io/badge/view-examples-blue)](https://github.com/restatedev/examples) [![Discord](https://img.shields.io/discord/1128210118216007792?logo=discord)](https://discord.gg/skW3AZ6uGd) [![Slack](https://img.shields.io/badge/Slack-4A154B?logo=slack&logoColor=fff)](https://join.slack.com/t/restatecommunity/shared_invite/zt-2v9gl005c-WBpr167o5XJZI1l7HWKImA) [![Twitter](https://img.shields.io/twitter/follow/restatedev.svg?style=social&label=Follow)](https://x.com/intent/follow?screen_name=restatedev) # Restate - Building resilient applications made easy! <p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://restate.dev/use-cases-dark.png"> <source media="(prefers-color-scheme: light)" srcset="https://restate.dev/use-cases-light.png"> <img alt="Restate overview" src="https://restate.dev/use-cases-light.png" width="100%"> </picture> </p> [Restate](https://restate.dev) is the simplest way to build resilient applications. Restate provides a distributed durable version of your everyday building blocks, letting you build a wide range of use cases: * [Durable AI Agents](https://github.com/restatedev/ai-examples) * [Workflows-as-Code](https://docs.restate.dev/use-cases/workflows) * [Microservice Orchestration](https://docs.restate.dev/use-cases/microservice-orchestration) * [Event Processing](https://docs.restate.dev/use-cases/event-processing) * [Async Tasks](https://docs.restate.dev/use-cases/async-tasks) * [Agents, Stateful Actors, state machines, and much more](https://github.com/restatedev/examples) ## Get started with Restate 1. 🏎 [Follow the Quickstart](https://docs.restate.dev/get_started/quickstart) to get Restate up and running within 2 minutes! 1. πŸ’‘ [The Tour of Restate](https://docs.restate.dev/get_started/tour) walks you through the most important features of Restate. ## SDKs Restate supports the following SDKs: * [Typescript](https://github.com/restatedev/sdk-typescript) * [Java and Kotlin](https://github.com/restatedev/sdk-java) * [Python](https://github.com/restatedev/sdk-python) * [Go](https://github.com/restatedev/sdk-go) * [Rust](https://github.com/restatedev/sdk-rust) ## Install We offer pre-built binaries of the CLI and the server for MacOS and Linux. Have a look at the [Quickstart](https://docs.restate.dev/get_started/quickstart) or [installation instructions in the docs](https://docs.restate.dev/develop/local_dev). ### Install the server Install via Homebrew: ```bash brew install restatedev/tap/restate-server ``` Run via npx: ```bash npx @restatedev/restate-server ``` Run via docker: ```bash docker run --rm -p 8080:8080 -p 9070:9070 -p 9071:9071 \ --add-host=host.docker.internal:host-gateway docker.restate.dev/restatedev/restate:latest ``` ### Install the CLI Install via Homebrew: ```bash brew install restatedev/tap/restate ``` Install via npm: ```bash npm install --global @restatedev/restate ``` Run via npx: ```bash npx @restatedev/restate ``` You can also download the binaries from the [release page](https://github.com/restatedev/restate/releases) or our [download page](https://restate.dev/get-restate/). ## Community * πŸ€—οΈ Join our online community on [Discord](https://discord.gg/skW3AZ6uGd) or [Slack](https://join.slack.com/t/restatecommunity/shared_invite/zt-2v9gl005c-WBpr167o5XJZI1l7HWKImA) for help, sharing feedback and talking to the community. * πŸ“– [Check out our documentation](https://docs.restate.dev) to get started quickly! * πŸ“£ [Follow us on Twitter](https://twitter.com/restatedev) for staying up to date. * πŸ™‹ [Create a GitHub issue](https://github.com/restatedev/restate/issues) for requesting a new feature or reporting a problem. * 🏠 [Visit our GitHub org](https://github.com/restatedev) for exploring other repositories. ## Core primitives The basic primitives Restate offers to simplify application development are the following: * **Reliable Execution**: Restate guarantees code runs to completion. Failures result in retries that use the [Durable Execution mechanism](https://docs.restate.dev/concepts/durable_execution) to recover partial progress and prevent re-executing completed steps. * **Reliable Communication**: Services communicate with exactly-once semantics: whether it's [request-response, one-way messages, or scheduled tasks](https://docs.restate.dev/concepts/invocations). Restate reliably delivers messages and uses Durable Execution to ensure no losses or duplicates can happen. * **Durable Promises and Timers**: Register Promises/Futures and timers in Restate to make them resilient to failures (e.g. sleep, webhooks, timers). Restate can recover them across failures, processes, and time. * **Consistent State**: Implement [stateful entities](https://docs.restate.dev/concepts/services) with isolated K/V state per entity. Restate persists the K/V state updates together with the execution progress to ensure consistent state. Restate attaches the K/V state to the request on invocation, and writes it back upon completion. This is particularly efficient for FaaS deployments (stateful serverless, yay!). * **Suspending User Code**: long-running code suspends when awaiting on a Promise/Future and resumes when that promise is resolved. This is particularly useful in combination with serverless deployments. * **Observability & Introspection**: Restate includes a UI and CLI to inspect the [state of your application](https://docs.restate.dev/operate/introspection) across services and invocations. Restate automatically generates Open Telemetry traces for the interactions between handlers. ## Contributing We’re excited if you join the Restate community and start contributing! Whether it is feature requests, bug reports, ideas & feedback or PRs, we appreciate any and all contributions. We know that your time is precious and, therefore, deeply value any effort to contribute! Check out our [development guidelines](/docs/dev/development-guidelines.md) and [tips for local development](/docs/dev/local-development.md) to get started. ## Versions Restate follows [Semantic Versioning](https://semver.org/). You can safely upgrade from a Restate `x.y` to `x.(y+1)` release without performing any manual data migration, as Restate performs an automatic data migration for you. For SDK compatibility, refer to the supported version matrix in the respective READMEs: * [Restate Java/Kotlin SDK](https://github.com/restatedev/sdk-java#versions) * [Restate TypeScript SDK](https://github.com/restatedev/sdk-typescript#versions) * [Restate Go SDK](https://github.com/restatedev/sdk-go#versions) * [Restate Python SDK](https://github.com/restatedev/sdk-python#versions) * [Restate Rust SDK](https://github.com/restatedev/sdk-rust#versions) ### Building Restate locally In order to build Restate locally [follow the build instructions](https://github.com/restatedev/restate/blob/main/docs/dev/local-development.md#building-restate). ", Assign "at most 3 tags" to the expected json: {"id":"10768","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"