Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
L

littlehorse

> 编程语言
Open source

LittleHorse Server: Workflow Engine for Microservice Orchestration & Business-as-Code, and the core of the Saddle Command Center

391 stars0 likes1 views
WebsiteGitHub

About

LittleHorse Server: Workflow Engine for Microservice Orchestration & Business-as-Code, and the core of the Saddle Command Center

About LittleHorse

LittleHorse is a high-throughput, low-latency orchestration engine that allows developers to codify processes spanning across agents, microservices, integrations, and workflows. LittleHorse's Business-as-Code approach allows you to write code that closely mirrors your business processes, creating better alignment between product & engineering while providing a robust durable execution platform.

Let LittleHorse take the reins and ditch the headaches of:

  • Wiring microservices together with RPC calls or message queues.
  • Managing the coordination and sequencing of your applications.
  • Retries, timeouts, dead-letter queues.
  • Distributed tracing and debugging across multiple microservices.
  • Scheduling actions to asychronously happen in the future.
  • Backpressure and scalability.

LittleHorse is built on Apache Kafka and Kafka Streams, and has two-way rich integrations with the Kafka Ecosystem. Workflows can be triggered by Kafka events and emit state changes back to Kafka in real time, enabling tight integration with event-driven architectures.

Business-as-Code

:point_up: This picture shows a running instance (WfRun) for the process (WfSpec) defined by this code :point_down:

…

As you can see, the code above closely mirrors our example KYC business process. LittleHorse handles retries, timeouts, and orchestration across services for you, allowing your WfSpec to focus just on what matters to the business. Task workers handle integrations with external systems and databases.

Getting Started

In this section, we'll run the "Know-your-Customer" quickstart shown above in a language of your choice. You should be able to run your first WfRun in minutes!

Start the LittleHorse Server

Run the LittleHorse Server and Dashboard using our standalone docker image:

bash
docker run --rm --pull=always --name littlehorse -d -p 9092:9092 -p 2023:2023 -p 8080:8080 ghcr.io/littlehorse-enterprises/littlehorse/lh-standalone:latest

Note: if you want to play with the output topic, which sends workflow updates to Kafka in real time, this also exposes a Kafka broker on localhost:9092.

Install the LittleHorse CLI

bash
brew install littlehorse-enterprises/lh/lhctl

Alternatively, you can install it from our GitHub Releases page

Once you have lhctl ready, let's use the whoami command to verify that the LittleHorse Server is up and running:

bash
lhctl whoami
json
{
  "id": {
    "id": "anonymous"
  },
  // ...
}

Run the Quickstart App

In this section, we'll start a program (in a language of your choice) which does four things:

  1. Register a couple TaskDefs (task definitions), which we'll compose into a workflow.
  2. Register an ExternalEventDef to keep track of callbacks from an external system.
  3. Register a WfSpec (workflow specification) to model the KYC proocess.
  4. Starts a few Task Workers which poll task queues in LittleHorse, waiting to be told to exxecute their tasks.

Java

./gradlew quickstart:run

Python

bash
cd examples/python
poetry run python -m quickstart.quickstart

GoLang

go run ./examples/go/quickstart

C#

bash
cd examples/dotnet/QuickstartExample
DOTNET_ROLL_FORWARD=Major dotnet run

JavaScript

First, install dependencies and start the task workers (this registers the required TaskDefs):

bash
cd examples/js/quickstart
npm install && npm start

Then in another terminal, register the ExternalEventDef and WfSpec (this quickstart uses lhctl; the JS SDK can also build and register WfSpecs in code — see examples/js):

bash
cd examples/js/quickstart
lhctl deploy externalEventDef identity-verified-external-event-def.json
lhctl deploy wfSpec quickstart-wfspec.json

Run a WfRun (Workflow Run)

In another terminal, run the quickstart workflow:

bash
lhctl run quickstart full-name 'Obi-Wan Kenobi' email [email protected] ssn 123456789

Now, navigate to the dashboard at http://localhost:8080 and inspect your first WfRun. You'll notice that the WfRun is stuck waiting at the ExternalEventNode: this is because we're waiting for the callback from the "identity check" service that the workflow called in the first step!

You can post a correlated event that unblocks the workflow, simulating a repsonse from the external service:

bash
lhctl put correlatedEvent [email protected] identity-verified BOOL true

See the per-language quickstarts for the full walkthrough:

  • Java quickstart
  • Go quickstart
  • Python quickstart
  • C# quickstart
  • JavaScript quickstart

You can also use lhctl to investigate! For starters:

  • lhctl get wfRun
  • lhctl get nodeRun 0 1
  • lhctl list taskRun

Learn More

  • Check out our Concepts Documentation!
  • Run more examples in our examples directory.
  • Join our Slack Community

Architecture

To run a workflow with LittleHorse, you need to:

  • Define tasks which are units of work that can be used in a process, and implement programs that execute those tasks.
  • Define your workflows and tell the workflow engine about it
  • Run the workflow
  • The workflow engine ensures that your process gets executed correctly.

To get started quickly with a basic workflow, try our quickstarts in Java, Go, Python, C#, and JavaScript. For more detailed examples, you can check out:

  • The examples directory in this repo
  • The lh-examples repository, which contains more complex applications.

For documentation, visit littlehorse.io/docs/server.

About the Project

LittleHorse is developed with love by engineers, for engineers.

Lifecycle and Release Plan

The LittleHorse Server follows Semantic Versioning after the release of version 1.0. You can find our (non-binding) project guidelines regarding our release schedule and deprecation strategy in our project lifecycle document.

Developing

For information about developing LittleHorse, see the guide in our local-dev README.

License

All code in the ./server and ./dashboard directories in this repository is licensed by the GNU Affero General Public License, Version 3 and is copyright of LittleHorse Enterprises LLC.

All docker images from this repository are licensed by the GNU Affero General Public License, Version 3 and are copyright of LittleHorse Enterprises LLC.

All other code and packages, including our SDK's, lhctl, examples, and the corresponding packages is licensed by the Apache License 2.0.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Javaapache-kafkabusiness-as-codeevent-driven-architecturekafka-streams

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言