LittleHorse Server: Workflow Engine for Microservice Orchestration & Business-as-Code, and the core of the Saddle Command Center
LittleHorse Server: Workflow Engine for Microservice Orchestration & Business-as-Code, and the core of the Saddle Command Center
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:
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.
: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.
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!
Run the LittleHorse Server and Dashboard using our standalone docker image:
docker run --rm --pull=always --name littlehorse -d -p 9092:9092 -p 2023:2023 -p 8080:8080 ghcr.io/littlehorse-enterprises/littlehorse/lh-standalone:latestNote: 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.
brew install littlehorse-enterprises/lh/lhctlAlternatively, 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:
lhctl whoami{
"id": {
"id": "anonymous"
},
// ...
}In this section, we'll start a program (in a language of your choice) which does four things:
TaskDefs (task definitions), which we'll compose into a workflow.ExternalEventDef to keep track of callbacks from an external system.WfSpec (workflow specification) to model the KYC proocess../gradlew quickstart:runcd examples/python
poetry run python -m quickstart.quickstartgo run ./examples/go/quickstartcd examples/dotnet/QuickstartExample
DOTNET_ROLL_FORWARD=Major dotnet runFirst, install dependencies and start the task workers (this registers the required TaskDefs):
cd examples/js/quickstart
npm install && npm startThen 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):
cd examples/js/quickstart
lhctl deploy externalEventDef identity-verified-external-event-def.json
lhctl deploy wfSpec quickstart-wfspec.jsonWfRun (Workflow Run)In another terminal, run the quickstart workflow:
lhctl run quickstart full-name 'Obi-Wan Kenobi' email [email protected] ssn 123456789Now, 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:
lhctl put correlatedEvent [email protected] identity-verified BOOL trueSee the per-language quickstarts for the full walkthrough:
You can also use lhctl to investigate! For starters:
lhctl get wfRun lhctl get nodeRun 0 1lhctl list taskRun To run a workflow with LittleHorse, you need to:
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:
For documentation, visit littlehorse.io/docs/server.
LittleHorse is developed with love by engineers, for engineers.
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.
For information about developing LittleHorse, see the guide in our local-dev README.
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.
No open issues yet, or sync has not completed.