https://github.com/cashapp/misk

Microservice Kontainer
https://github.com/cashapp/misk

Last synced: 3 months ago
JSON representation

Microservice Kontainer

• Host: GitHub
• URL: https://github.com/cashapp/misk
• Owner: cashapp
• License: apache-2.0
• Created: 2017-12-04T23:31:52.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2025-04-25T16:58:21.000Z (11 months ago)
• Last Synced: 2025-04-25T17:54:05.432Z (11 months ago)
• Language: Kotlin
• Homepage: https://cashapp.github.io/misk/
• Size: 23.5 MB
• Stars: 425
• Watchers: 34
• Forks: 175
• Open Issues: 171
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md

Awesome Lists containing this project

• awesome-java - Misk

README

          


[](http://search.maven.org/#search%7Cga%7C1%7Ccom.squareup.misk)

* Releases

    * See most recent [public build][snap]

    * [Changelog][changelog]

    * API is subject to change

* Documentation

    * [Project Website][misk]

    * [Getting Started](./docs/getting-started.md)

    * [Developer Guide](./docs/developer-guide.md)

* Related

    * [misk-web][miskweb]: a now deprecated React framework used for the Misk Admin Dashboard v1

    * [wisp](./wisp/README.md): some Misk artifacts that are published without use of the Guice Direct Injection library

# Overview

## What is Misk

Misk (Microservice Container in Kotlin) is an open source microservice container from Cash App.

It allows you to quickly create a microservice in Kotlin or Java, and provides libraries for common

concerns like serving endpoints, caching, queueing, persistence, distributed leasing and clustering.

It also includes [the Wisp library](./wisp/README.md), which is a collection of Kotlin modules

providing various features and utilities, including config, logging, feature flags and more.

It has been powering hundreds of microservices within Cash App since 2018.

## A Tour of Features

* Server

    * Built on top of [Jetty](https://eclipse.dev/jetty/)

    * HTTP/2 and gRPC support

    * Configurable through YAML

    * Service management through [Guava](https://github.com/google/guava/wiki/ServiceExplained)

    * Web-based admin console

* Client

    * Configurable HTTP clients built on top of [OkHttp](https://github.com/square/okhttp)

    and [Retrofit](https://github.com/square/retrofit)

    * gRPC clients built on top of [Wire](https://github.com/square/wire)

* Cloud integration

    * AWS: SQS, S3, DynamoDB

    * Google Cloud: Spanner

* Scheduled Jobs with cron syntax

* Persistence

    * ORM: [SqlDelight](https://cashapp.github.io/sqldelight/), JOOQ, Hibernate

    * JDBC: Connection pooling through [Hikari](https://github.com/brettwooldridge/HikariCP)

* Cache: redis client

* Metrics:

    * Integration with prometheus

    * Built-in metrics for JVM performance, networking and connection pooling

* Testing framework with annotations

* Kotlin utilities with minimal dependencies: [Wisp](wisp/README.md)

## What's Next?

Want to jump right into it? Check out our [Getting Started Guide](./docs/getting-started.md).

What to know more about each module, see [Developer Guide](./docs/developer-guide.md).

[changelog]: changelog.md

[misk]: https://cashapp.github.io/misk/

[miskweb]: https://github.com/cashapp/misk-web/

[snap]: https://mvnrepository.com/artifact/com.squareup.misk/misk