Wingfoil
========
Wingfoil is a `blazingly fast <https://github.com/wingfoil-io/wingfoil/tree/main/wingfoil/benches/>`_, highly scalable
stream processing framework designed for latency-critical use cases such as electronic trading
and real-time AI systems.
Wingfoil simplifies receiving, processing and distributing streaming data across your entire stack.
Checkout the `wingfoil project page <https://github.com/wingfoil-io/wingfoil/>`_ for more information.
Features
--------
- **Fast**: Ultra-low latency and high throughput with an efficient `DAG <https://en.wikipedia.org/wiki/Directed_acyclic_graph>`_ based execution engine.
- **Simple and obvious to use**: Define your graph of calculations; Wingfoil manages its execution.
- **Multi-language**: currently available as rust crate and a python package with plans to add WASM/JavaScript/TypeScript support.
- **Backtesting**: Replay historical data to backtest and optimise strategies.
Release Status
--------------
The wingfoil python module is currently available as **beta release**.
Installation
------------
.. code-block:: bash
pip install wingfoil
Quick Start
-----------
This python code:
.. code-block:: python
#!/usr/bin/env python3
from wingfoil import ticker
period = 1.0 # seconds
duration = 4.0 # seconds
stream = (
ticker(period)
.count()
.logged("hello, world")
)
stream.run(realtime=True, duration=duration)
Produces this output:
.. code-block:: console
[2025-11-02T18:42:18Z INFO wingfoil] 0.000_092 hello, world 1
[2025-11-02T18:42:19Z INFO wingfoil] 1.008_038 hello, world 2
[2025-11-02T18:42:20Z INFO wingfoil] 2.012_219 hello, world 3
You can follow these instructions to `build from source <https://github.com/wingfoil-io/wingfoil/blob/main/wingfoil-python/build.md>`_.
We want to hear from you! Especially if you:
- Are interested in contributing
- Know of a project that Wingfoil would be well-suited for
- Would like to request a feature
- Have any feedback
Please email us at `hello@wingfoil.io <mailto:hello@wingfoil.io>`_ or get involved in the `wingfoil discussion <https://github.com/wingfoil-io/wingfoil/discussions/>`_. Take a look at the `issues <https://github.com/wingfoil-io/wingfoil/issues>`_ for ideas on ways to contribute.