Wallaroo 0.6.o has been released! Check out the beautiful new API to go along with our Python 3 support.

Learn more

Introducing Connectors: Wallaroo’s Window to the World


We’re excited today to introduce you to a preview release of a new Wallaroo feature: Connectors. Connectors make inputting and receiving data from Wallaroo even easier.

In this post, we’ll briefly go over what Wallaroo is, the role connectors now play as Sources and Sinks for Wallaroo, how to get started with connectors, and talk about what is coming next.

If you’re familiar with what Wallaroo is feel free to skip the next section.

What is Wallaroo

Wallaroo is a framework designed to make it easier for developers to build and operate high-performance applications written in Python. It handles the complexity of building distributed data processing applications so all that you need to worry about is the domain logic.

Our goal is to make sure regardless of where you data is coming from you can scale your application logic horizontally. All while removing the challenges that otherwise come with distributed applications.

Sources and Sinks

There are a few pieces of terminology that I would like to go over before we continue.

Here’s a high level diagram of how data moves from an external source through Wallaroo to an external sink:


There are two terms that may be new to you that I’ll mention quite a bit in this blog post. An external source is the application that sends Wallaroo data from an external system; this can also be considered the input. An external sink is the application Wallaroo sends data to or the output. Currently every pipeline needs a Source and a Sink.


With our 0.5.3 release last month, we released a preview of our new Connector APIs. Before when you wanted to write a Source or Sink, we didn’t provide a recommended way to encode/decode your data to and from Wallaroo. This led to the user needing to come up with a protocol to serialize their data.

The preview release of these new APIs includes a new Python module containing a set of simple abstractions. Connectors are swappable. You can switch your data source from one type to another by changing the connector. Nothing about your Wallaroo application has to change. You can even use other Python libraries, like Wallaroo applications you aren’t constrained to which additional libraries you can use.

high-level-overview Each blue square is a separate OS process

The Connector APIs and Wallaroo don’t make any assumptions on how you are communicating with your external data sources. Connectors can be run on the same machine or a separate machine from your Wallaroo application. This is because Connectors are a separate OS process and communicate to Wallaroo via TCP.

Templates and Starting Points

Along with these new APIs, we’ve written some example Connectors. These are designed to be copied and pasted as Python applications and started like scripts. You can use these starting points either from the Wallaroo repository or bring them into your own repository and modify them to fit your needs. Take a look at our Connector documentation to learn more.

connector = wallaroo.experimental.SinkConnector(
    required_params=[], optional_params=[])

The new APIs include an easy way to pass additional arguments to your Connector scripts. These can either be passed in as required or optional parameters. See “Running Connector Scripts” for more information.

The examples we have provided are Kafka, Redis, RabbitMQ, UDP, S3, and Kinesis. Use these as starting points for your Sources and Sinks. We really appreciate any feedback you provide and your feedback will help shape our APIs as we look to release these. When writing a Connector feel free to use other Python libraries as well.

Additionally we have a PostgreSQL template that demonstrates how to use the PostgreSQL LISTEN/NOTIFY API to pass change events to Wallaroo. This template requires a little more specific logic to get working but should be a great example on how to get started.


To Summarize:

  • Connectors can use any other additional Python libraries

  • Connectors are separate OS processes to your Wallaroo application

  • The new APIs provide an easier abstraction around the original TCP Connector

  • How your data sources and the Connectors communicate is up to you. This could be something like JSON or a custom protocol.

We’re continuing to develop these APIs, so look for developments in the next few releases.

If you’re interested in giving the new APIs a try, see the available examples here and our Connectors documentation. While this is a preview release of Connectors, please let us know if you thoughts or feedback. The best way is either via IRC or our mailing list.

If you’re looking to get started with Wallaroo for the first time, you can install Wallaroo via docker:

docker pull \

Other installation options can be found here.

Thank you to my co-workers Andy and John who helped me outline and proof-read this post.

Did you enjoy this post?

Subscribe to our blog and be updated each time we add a new post.

Other posts you might also like: