Skip to main content

OPERA: Open-Source Prediction Evaluation and Real-Time Analysis

Documentation

OPERA is a modular ecosystem aimed at streamlining forecasting tasks for economists and fostering open collaboration. Model logic - estimation, forecasting, forecast decomposition - is separated from the real-time workflow, making it easier to compare models in replicable environments and leverage open source contributions. The ecosystem is currently composed of seven blocks which cover the full pipeline from raw data to evaluation. Its architecture, interfaces and design principles reflect the specific constraints of macro analysis: data revision, ragged edge, mixed-frequency, conditional projections, uncertainty quantification, narrative accounting and nested models. By making these modules open-source, OPERA provides a platform for central bankers, academics and other forecasters to share infrastructure and collaborate.


Architecture

Forecasting Ecosystem Architecture


Modules

Module Package Role
Model Libraries bvar, nowcast-midas Bayesian VARs; mixed-data sampling and SC-MIDAS combinations
Forecast Evaluation forecast_evaluation Validate data, evaluate accuracy, run statistical tests, visualise
Real-time Forecasting forecast_realtime Fit and forecast wrappers, backtesting, simulation, stress-testing, R/MATLAB/Julia adapters
Forecast Combination forecast_combo Inverse-error, regression and hierarchical combination
News Decomposition news_decomp Nowcast decomposition into level and revision; news/reestimation/interaction

Install all ecosystem packages with pip install "opera-eco[modules]".

Authors

The package authors listed in each repository's pyproject.toml are:

Package Authors
opera-eco Paul Labonne; Diego Lopez
forecast_evaluation James Hurley; Paul Labonne; Harry Li
forecast_realtime Paul Labonne; Sumer Singh; Harry Li; Nades Raviraj
bvar Paul Labonne; Andrea Renzetti; Joseph Oyegoke
nowcast-midas James Kensett; Paul Labonne; Andre Moreira
forecast_combo Filippo Busetto; Paul Labonne; James McConachie; Roshni Tara
news_decomp Guido Bonatti; Kensley Blaise; Paul Labonne; Nades Raviraj

Quick Start

pip install opera-eco              # Install the CLI and skills only.
pip install "opera-eco[modules]"  # Install the CLI and all ecosystem packages.
pip install "opera-eco[notebooks]" # Install Marimo notebook tooling.
opera install skills               # Install AI skills in .claude/skills/.

Then ask Copilot or Claude to use an installed skill:

Tell me about @opera and how I can use it with my model.

OPERA Skills for Claude and Copilot

The package includes seven skills for AI coding assistants:

Skill Description
opera Meta-skill covering the full ecosystem: architecture, modules, data flows, conventions, integration patterns
forecast-evaluation Data validation, accuracy metrics, statistical tests, visualisations, dashboards
forecast-realtime Real-time forecasting, backtesting, model wrapping, external language models (R, MATLAB, Julia)
bvar Bayesian VARs, conditional forecasting with hard/soft/skewed constraints, GIRFs
nowcast-midas MIDAS regressions, MultiMIDAS, SC-MIDAS combinations, monthly-to-quarterly nowcasting
forecast-combo Forecast combination methods, hierarchical pooling, weight analysis
forecast-decomp Nowcast decomposition: levels and revisions, news, reestimation, interaction, and New York Fed-style analysis

Project Layout

docs/                            # Documentation site.
examples/illustration.py        # Runnable end-to-end example.
examples/illustration_marimo.py # Native Marimo version of the example.
src/opera/                      # Package source, bundled skills, and tests.
  cli.py                        # Command-line interface.
  skills_manager.py             # Skill discovery and installation.
  skills/                       # Bundled Markdown skill files.
pyproject.toml                  # Python package configuration.
zensical.toml                   # Documentation site configuration.

Data Classification

Bank of England Data Classification: OFFICIAL BLUE

Release files for opera-eco 0.4.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for opera-eco 0.4.6
File Size Uploaded
opera_eco-0.4.6.tar.gz 95.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for opera-eco 0.4.6
File Interpreter ABI Platform
opera_eco-0.4.6-py3-none-any.whl Python 3 none any Details

Total release size: 203.6 kB

Release files / opera_eco-0.4.6.tar.gz

Download URL opera_eco-0.4.6.tar.gz
Size 95.4 kB
Tags Source
SHA-256 checksum
How to use checksums
2ecf698473392d49c4ecabc45913642dd17c72482314732e225c00473593e27d
BLAKE2b-256 checksum
How to use checksums
8a4e50fb48be9a4e04e765a3c70dd8e3071cf91e416383a3fcc3b4fc29f34d24
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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 Aug 30, 2026.

Transparency log

Release files / opera_eco-0.4.6-py3-none-any.whl

Download URL opera_eco-0.4.6-py3-none-any.whl
Size 108.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b0b1278612b64a4a68b78709b5e417d71ad0ffe0cea31fbf521b8fb12565eeba
BLAKE2b-256 checksum
How to use checksums
b0ade38db3a0bf78c71a675908dbd2faa0c1890b9c1e39fc5d74da8f8095b56d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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 Aug 30, 2026.

Transparency log

Release history Release notifications | RSS feed

0.4.18

2 release files

0.4.17

2 release files

0.4.16

2 release files

0.4.15

2 release files

0.4.14

2 release files

0.4.10

2 release files

0.4.9

2 release files

0.4.8

2 release files

0.4.7

2 release files

This release

0.4.6 This release

2 release files

0.4.5

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page