What is Effect Prophet?
Effect Prophet forecasts future values of a time series, such as daily sales, website visits or server load, from its past values.
It is a TypeScript version of Prophet, a forecasting library from Meta that is popular because it works well on everyday business data without much tuning. Effect Prophet uses the same model and is tested against the Python version.
- One dependency. Effect is the only package it depends on.
- No Stan install. Prophet's fitting runs on Stan. The parts Prophet uses are ported to Rust and compiled to WebAssembly, which ships inside the package.
How a forecast is built
Prophet treats your data as a few simple pieces added together:
| Piece | What it captures | Example |
|---|---|---|
| Trend | The long-term direction | Sales growing 2% a month |
| Seasonality | Patterns that repeat on a schedule | Busier on weekends, quiet in March |
| Events | One-off or yearly days that behave differently | Black Friday, a product launch |
| Regressors | Other things you know that affect the value | Temperature, ad spend |
| Noise | Everything left over that the model can't explain | Random day-to-day wobble |
Because the pieces are kept separate, every forecast tells you not just what it expects but why: how much comes from the trend, how much from the day of the week, and so on.
When it works well
- You have at least a few weeks of history, ideally a year or more for yearly patterns.
- The data has clear patterns: weekly or yearly cycles, holidays, a trend.
- You want a reasonable forecast quickly, and want to be able to explain it.
When to look elsewhere
- Very short or very noisy histories with no repeating patterns.
- Problems that depend on many interacting inputs. A general machine-learning model may do better.
- Minute-by-minute data where the next few points depend mostly on the last few.
AI disclosure
Effect Prophet is a TypeScript port of Meta's Python Prophet, and most of the code was written with AI assistance. The forecasting maths is easy to get subtly wrong, so the project doesn't ask you to take correctness on trust. Results are checked against Python Prophet itself, and you can see how closely they match in the benchmarks and the accuracy comparison.
If you find a case where the results differ from Python Prophet, please open an issue.
Why "Effect"?
The library is built on Effect, a TypeScript library for writing reliable programs. You don't need to know Effect to use this library. The five-minute introduction covers everything you need.
Effect is also why tracing comes built in. Every fit and forecast is traced automatically, ready to send to Jaeger or any OpenTelemetry backend.
Ready? Make your first forecast.