KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

monstera

★ 57 Open GitHub ↗

Framework for building scalable distributed stateful applications

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Monstera

[![Tests](https://github.com/evrblk/monstera/actions/workflows/ci.yml/badge.svg)](https://github.com/evrblk/monstera/actions/workflows/ci.yml)
[![Go Reference](https://pkg.go.dev/badge/github.com/evrblk/monstera.svg)](https://pkg.go.dev/github.com/evrblk/monstera)

![Monstera leaf](https://raw.githubusercontent.com/evrblk/monstera/master/monstera.jpg)

Monstera is a framework for writing stateful applications in pure Go with all data in memory or on disk without 
worrying about scalability and availability. Monstera takes care of replication, sharding, snapshotting, 
and rebalancing.

Monstera is a half-technical and half-mental framework. The tech part of it has a pretty small surface. It leaves a 
lot up to you to implement. But sticking to the framework principles will ensure:

* Applications are insanely fast and efficient
* Cluster is horizontally scalable
* Business logic is easily testable
* Local development is enjoyable

Data and compute are brought together into a single process. You are free to use any in-memory data structure or 
embedded database. By eliminating network calls and limited query languages for communication with external databases, 
you are able to solve problems which are known to be hard in distributed systems with just a few lines of your 
favorite programming language as you would do it on a whiteboard.

Go to [documentation](/docs/overview.md) to learn more.

## Example

It might be easier to understand how it works from examples rather than from the documentation.

* [evrblk/grackle](https://github.com/evrblk/grackle) is a complete production-ready application built with Monstera.

## Installing

Use go get to install the latest version of the library.

```shell
$ go get -u github.com/evrblk/monstera@latest
```

There are also few CLI tools (such as codegen), so it also should be added as a tool:

```shell
$ go get -tool github.com/evrblk/monstera/cmd/monstera@latest
```

## CLI

Monstera comes with CLI toolkit:

```shell
$ go tool github.com/evrblk/monstera/cmd/monstera
```

* Code generation:
  * `monstera code generate` Generates stubs, core interfaces and adapters from `monstera.yaml` file.
* Working with cluster configs (offline: edit a config file on disk):
  * `monstera config init` Creates a new cluster config.
  * `monstera config add-node` Adds a node to the cluster config.
  * `monstera config add-application` Adds an application to the cluster config.
* Operating a running cluster (online: over the admin plane):
  * `monstera cluster bootstrap-node` Provisions a single unprovisioned node with its id and the
    initial cluster config, transitioning it to READY.
  * `monstera cluster bootstrap-nodes` Provisions every node listed in a cluster config, dialing each
    at its advertised gRPC address.
  * `monstera cluster add-node` Adds a node to a running cluster (rolls the new config out to all nodes, 
    then bootstraps the newcomer).
  * `monstera cluster move-shard` Moves a shard replica from one node to another (add new replica, bake 
    until caught up, then remove the old one).
  * `monstera cluster split-shard` Splits an active shard into two children at a given key
    (seed children, flip, bake).
  * `monstera cluster get-config` Downloads the cluster config a node is currently running and prints
    it (or writes it to a file).

## Status

Monstera is being actively developed. There will be no version tagging before `v0.1`, just development in `master` 
branch. After it is tagged `v0.1` it will be more or less stable and follow semver.

## License

Monstera is released under the [MIT License](https://opensource.org/licenses/MIT).

monstera

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README