Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

chili-core Build Status

The chili core is an opinionated framework for creating microservices with focus on speed of development and time to market. It's based on the Vert.x toolkit for maximum power and uses Hazelcast for plug-and-play clustering. This project is small with only 22k LOC.

Find the official documentation here.


Using gradle

repositories {
    maven { url '' }

dependencies {
    compile "com.github.codingchili.chili-core:core:<version>"

Creating a new handler

public class MyHandler implements CoreHandler {
    private Protocol<Request> protocol = new Protocol<>(this);
    public void list(Request request) {
        request.write(new ArrayList<>(Arrays.asList("hello", "world")));
    public void handle(Request request) {

Deploying a handler with the REST listener on port 8080 (default).

public static void main(String[] args) {
    ListenerSettings settings = new ListenerSettings()

    CoreContext core = new SystemContext();

    core.listener(() -> new RestListener()
            .handler(new MyHandler()));

Start it up and check the service with

curl -v http://localhost:8080/api/list


To build chili-core clone this repository with git,

git clone

Builds project jars and run tests

gradlew build

Note: when targeting java 9+ the following hacks are needed for Netty/Vert.x

--add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/ --add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.base/ --add-opens=java.base/java.lang.reflect=ALL-UNNAMED --add-opens=java.base/java.nio=ALL-UNNAMED --add-opens=java.base/


The purpose of wrapping vertx in a framework is to increase productivity. This is done by providing common functionality that can be used to build microservices on as a framework. With all the logic packed into core, it is possible to create distributed microservices capable of handling authentication, request routing and storage in 66 lines of code. If you are interested in vertx, I recommend using it directly instead. This framework is intended to improve productivity for a single developer, aka the author. In order to achieve this it is much more invasive than the vertx toolkit.

  • Built on the high-performance reactive toolkit vertx
  • Uses clustering to improve scalability
  • Support for a variety of storage options, query API's and a DSL.
  • A distributed logging system and logging aggregator
  • Highly adaptable and flexible with a configuration system
  • High availability with support for multiple transports
  • Text based protocols with JSON
  • Adopts the microservice pattern


The complete feature list may change during development.

  • Transport & storage independent implementations
  • Logging system for data analysis and real time monitoring
  • Authentication based on signed tokens.
  • A router for routing external connections into the clustered event bus.
  • Statistics API that builds on top of the logging system
  • Interchangeable storage options with indexing and query support
  • Programmers seeking to create microservices productively in a very specific use case.
  • Game, web-app or mobile-app developers with an interest in backend development.

Makes use of

The core uses some great software, such as

Optional dependencies

Read the documentation to learn more about optional dependencies.

Applications currently using chili-core

application description
mutable-bunnies 2D MMORPG game in development.
zapperfly-asm Extra simple clustered build servers.
ethereum-ingest Ethereum block/transaction import utility.
flashcards Progressive web app for studying with flashcards.


Issues and PR's are welcome with 💙.


The MIT License (MIT) Copyright (c) 2019 Robin Duda

See: License