Stream Processing and Complex Event Processing Engine
Branch: master
Clone or download
mohanvive Merge pull request #1038 from Niveathika92/master
Refactor Aggregation testcases
Latest commit b93a6f0 Feb 15, 2019


Jenkins Build Status GitHub (pre-)release GitHub (Pre-)Release Date GitHub last commit License

Siddhi is a java library that listens to events from data streams, detects complex conditions described via a Streaming SQL language, and triggers actions. It performs both Stream Processing and Complex Event Processing.


Siddhi supports the following:

  • Data preprocessing
  • Generating alerts based on thresholds
  • Calculating aggregations over a short window or a long time period
  • Joining multiple data streams
  • Correlating data while finding missing and erroneous events
  • Interacting streaming data with databases
  • Detecting temporal event patterns
  • Tracking (something over space or time)
  • Analyzing trends (rise, fall, turn, tipple bottom)
  • Making real-time predictions with existing and online machine learning models
  • And many more ... For more information, see Patterns of Streaming Realtime Analytics

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

Table of contents

Get Started!

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

Why use Siddhi ?

If you are a Siddhi user, we would love to hear more.

Develop Siddhi using IntelliJ IDEA

Install IDEA plugin to get the following features:

  • Siddhi Query Editor with syntax highlighting and with basic auto completion
  • Siddhi Runner and Debugger support to test Siddhi Application

Try Siddhi with WSO2 Stream Processor

WSO2 Stream Processor is a server version of Siddhi that is 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.

If you use WSO2 Stream Processor, you can use the Siddhi functionality with the following additional features:

  • The Siddhi Query Editor tool with syntax highlighting and advanced auto completion support
  • The Siddhi Runner and Debugger tool
  • The Event Simulator tool
  • 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.

For more information please contact us via

Siddhi Versions

Find the released Siddhi libraries here.

Latest API Docs

Latest API Docs is 5.0.0-m1.

How to Contribute

Build from the Source


Steps to Build

  1. Get a clone or download source from Github

    git clone
  2. Run the Maven command mvn clean install from the root directory

Contact us


  • We are committed to ensuring support for Siddhi (with its 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.