Screamer
A fast C++ library for researching and trading time series: rolling statistics, technical indicators, filters, order-flow measures, costed backtests of single assets, portfolios, and pairs, and significance tests. One C++ core, two languages: a Python API and a JavaScript/WebAssembly build.
Screamer runs in Python and in JavaScript. Both bind the same C++ engine, so results agree to within floating-point rounding, and seeded randomization gives identical draws in both.
Why screamer
- Fast. Every operator is implemented in C++ and routinely outruns equivalent NumPy and pandas code, often by a factor of two or more.
- One API, batch or streaming. The same operator runs on a stored array or a live, event-driven stream, so code tested on historical data deploys to production unchanged.
- Causal by construction. Output depends only on current and past inputs, never future ones, which eliminates look-ahead bias.
- Broad coverage. 250+ operators: rolling and exponentially weighted statistics, technical indicators (MACD, RSI, Bollinger Bands, ATR, and more), OHLC volatility estimators, signal filters, market microstructure, stream operators, and composable pipelines.
- Backtesting and validation. Costed backtests on prices, bars, trades, or quotes, with slippage, fill timing, stops, and funding; portfolios of many assets from one account; pairs and cross-sectional tools; and randomization tests, the deflated Sharpe ratio, and walk-forward evaluation to tell skill from luck.
- Python and JavaScript. The same operators and the same pipeline model in both ecosystems, from one C++ source.
Python
Python 3.12 or newer.
pip install screamer
The wheel is self-contained (a single abi3 wheel per platform, no build step and no runtime dependencies). For development setup and the example notebooks see the Installation page.
Fit a quadratic to each sliding window of 50 values, take its slope at the latest value, then the sign of the slope to get the trend direction:
import numpy as np
from screamer import RollingPoly2, Sign
data = np.cumsum(np.random.normal(size=300))
slope = RollingPoly2(window_size=50, derivative_order=1)
sign = Sign()
trend = sign(slope(data)) # the same calls work on a live stream, one value at a time
JavaScript
Node 18 or newer, or Chrome 95, Firefox 100 or Safari 15.2 or newer. The WebAssembly module uses native WebAssembly exceptions, which older browsers lack.
npm install @screamer-labs/screamer
The package is self-contained: the WebAssembly module is embedded, so there is no
separate asset to configure. The WASM loads once via await ready(), then you
call operators directly:
import { ready, RollingPoly2, Sign } from "@screamer-labs/screamer";
await ready();
const data = Float64Array.from({ length: 300 }, () => Math.random());
const slope = RollingPoly2(50, 1); // window_size, derivative_order
const sign = Sign();
const trend = sign(slope(data)); // a number, a Float64Array, an iterable, or an async stream
Operators compose into pipelines:
import { ready, Input, Pipeline, RollingMean, Diff } from "@screamer-labs/screamer";
await ready();
const x = Input("x");
const y = Diff(1)(RollingMean(3)(x)); // compose operators into a graph
const p = new Pipeline([x], [y]);
p(data); // bind data at call time; p.live() streams
Documentation
- Start here: Your first strategy goes from price data to a costed backtest and a p-value in one page.
- Python: guides, recipes, runnable notebooks, and the full reference grouped by topic live at screamer.readthedocs.io.
- JavaScript: see
js/README.mdfor install and the API. JavaScript API reference and guide: screamer-labs.github.io/screamer. - AI agents:
python -m screamer.docs search <keywords>andshow <Name>describe every function of the installed version, andpip install "screamer[mcp]"adds an MCP server. See Using screamer with AI agents.
Contributing
Contributions are welcome. See CONTRIBUTING.md for how to set up a development environment, build the extension, run the tests, and open a pull request. By participating you agree to abide by our Code of Conduct.
License
Screamer is released under the MIT License. See LICENSE.
Release files for screamer 3.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| screamer-3.3.0.tar.gz | 8.9 MB | With provenance | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| screamer-3.3.0-cp312-abi3-win_amd64.whl | CPython 3.12 | abi3 | Windows x86-64 | Details |
| screamer-3.3.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 | Details |
| screamer-3.3.0-cp312-abi3-macosx_11_0_arm64.whl | CPython 3.12 | abi3 | macOS 11.0+ ARM64 | Details |
| screamer-3.3.0-cp312-abi3-macosx_10_13_x86_64.whl | CPython 3.12 | abi3 | macOS 10.13+ x86-64 | Details |
Total release size: 16.3 MB
Release files / screamer-3.3.0.tar.gz
| Download URL | screamer-3.3.0.tar.gz |
|---|---|
| Size | 8.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ea0ebdd0a5402bb405425e1341f9fb8383116e7a164f0a4fb8226446d3d36463
|
|
BLAKE2b-256 checksum How to use checksums |
8fa7f0ff2153e80bfb1df6fc7a3b8a8a13fc8b4fe42de9c5104b86922939b232
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / screamer-3.3.0-cp312-abi3-win_amd64.whl
| Download URL | screamer-3.3.0-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 1.4 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
dc762480ee28d97638eed9f0a5103ab56561e4bcb00e383764b45cd75f342a67
|
|
BLAKE2b-256 checksum How to use checksums |
c72b5a9feebdc1763ec3ba5a793a932b4dcd73c28924fdbe64ebfcf4dc7f5a35
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / screamer-3.3.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | screamer-3.3.0-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
ee038271c2fbe10e4e2cf3fda64ffc1da73738d9448cf2e083d451e3970655b6
|
|
BLAKE2b-256 checksum How to use checksums |
8fed4f81992330c3d724875aba8250b751702169cacd0e292a24a17daac0e744
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / screamer-3.3.0-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | screamer-3.3.0-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
322e86f524c871ecbdad23c68154bad5f1c207cf618429a740f17b521ec68a8d
|
|
BLAKE2b-256 checksum How to use checksums |
3dc0f52c9e1ddd02c79cbbd7ab5900ed8a3da793b2669e24f1f564476953986c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / screamer-3.3.0-cp312-abi3-macosx_10_13_x86_64.whl
| Download URL | screamer-3.3.0-cp312-abi3-macosx_10_13_x86_64.whl |
|---|---|
| Size | 1.9 MB |
| Tags | CPython 3.12 abi3 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
f4fd398f67522694a8aea8a94c150577efcb774babc2899b335e9ad8589e14c1
|
|
BLAKE2b-256 checksum How to use checksums |
8d24cf14c96c235f8f4399933bf2798a0a107da0b63537618278352cd8704a68
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logSecurity for screamer 3.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 5 files in this release have been uploaded with provenance metadata.
Attestation for screamer-3.3.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
