WSO2 Siddhi

Siddhi is a java library that listens to events from data streams, detect complex conditions described via a Streaming SQL language, and trigger actions. It can be used to do both Stream Processing and Complex Event Processing.


It can be used for;

  • Data preprocessing
  • Generate alerts based on thresholds
  • Calculate aggregations over a short window or a long time period
  • Joining multiple data streams
  • Data correlation while finding missing and erroneous events
  • Interact streaming data with databases
  • Detecting temporal event patterns
  • Tracking (something over space or time)
  • Trend analysis (rise, fall, turn, tipple bottom)
  • Real-time predictions with existing and online machine learning models
  • And many more ... “Patterns of Streaming Realtime Analytics”

Siddhi is free and open source, under Apache Software License v2.0.

Get Started!

Get started with Siddhi in few minutes by following Siddhi Quick Start Guide

Why use Siddhi ?

If you also use Siddhi, we would love to hear more.

Try Siddhi with WSO2 Stream Processor

WSO2 Stream Processor is a server version of Siddhi that's also released under Apache Software License v2.0. It was a Strong Performer in The Forrester Wave™: Big Data Streaming Analytics, Q1 2016 (Report) and a Cool Vendors in Internet of Things Analytics, 2016.

To get following capabilities by using WSO2 Stream Processor :

  • Siddhi Query Editor
  • Siddhi Debugger
  • Event Simulator
  • Run Siddhi as a Server with High Availability and Scalability
  • Monitoring support for Siddhi
  • Realtime dashboard
  • Business user friendly query generation and deployment

There are domain specific solutions built using Siddhi, including Fraud Detection, Stock Market Surveillance, Location analytics, Proximity Marketing, Contextual Recommendation, Ad Optimization, Operational Analytics, and Detecting Chart Patterns.

If you want more information please contact us via

Siddhi Versions

Find the released Siddhi libraries from here.

  • Active development version of Siddhi : v4.0.0 built on Java 8.

    Siddhi Query Guide for Siddhi v4.x.x

  • Latest Stable Release of Siddhi : v3.0.5 built on Java 7.

    Siddhi Query Guide for Siddhi v3.x.x

Latest API Docs

Latest API Docs is 4.0.0-M83.

Jenkins Build Status

Siddhi Branch Jenkins Build Status
master Build Status

How to Contribute

Contact us


  • We are committed to ensuring support for Siddhi (with it's extensions) and WSO2 Stream Processor from development to production.
  • Our unique approach ensures that all support leverages our open development methodology and is provided by the very same engineers who build the technology.
  • For more details and to take advantage of this unique opportunity contact us via

Siddhi was joint research project initiated by WSO2 and University of Moratuwa, Sri Lanka.