wingfoil-python 2.1.0

python bindings for wingfoil - graph based stream processing framework
Documentation
# 🚀 Wingfoil

Wingfoil is a **blazingly fast**, highly scalable [stream processing framework](https://github.com/wingfoil-io/wingfoil/tree/main/wingfoil/benches/) 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 a 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 a **beta release**.

---

## 📦 Installation

```bash
pip install wingfoil
```

## âš¡ Quick Start

This python code:

```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:

```bash
[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
```

### Building from source

You can follow these instructions to [build from source](https://github.com/wingfoil-io/wingfoil/blob/main/wingfoil-python/build.md).

### Contact us

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.