This release is a pre-release and may not be stable for production use.
pyeconomics
Status: 1.0.0a2 is an alpha pre-release on PyPI. Install explicitly with
pip install --pre pyeconomics==1.0.0a2(Python 3.12 or later). Plainpip install pyeconomicsstill installs 0.2.6, the stable release. Pre-releases carry no stability promise until 1.0.0.
pyeconomics provides 50 tested, cited economics and finance model
families across 13 domains: foundations, fixed income, derivatives,
international, equity, corporate, accounting, portfolio, performance, risk,
econometrics, macroeconomics and asset pricing. The data platform adds 31
providers, 171 catalog concepts and live bindings with real-time vintages.
Typed inputs declare units and bounds; every result carries
a reproducible provenance manifest. Rates and percentages are decimals:
0.05 means 5%.
Use the 1.0 documentation preview
for formulas, assumptions and examples, and the
alpha release notes
for the catalog and known limitations. See the
data guide and
keys guide to connect
your sources. Install optional econometrics and plotting support
with pip install --pre "pyeconomics[econometrics,plot]==1.0.0a2".
This alpha replaces the 0.2.x API and restores monetary-policy rules on the new model engine. A command line, REST API, MCP server and web app arrive in later phases; the project roadmap and architecture decisions record that plan. Keep legacy workloads in a separate environment.
pyeconomics 0.2.x
0.2.6 is the current stable release of the 0.2.x line: four monetary-policy rules over FRED data.
- It is MIT-licensed. Its source lives on the
legacy/0.2.xbranch, and its documentation at https://pyeconomics.readthedocs.io/. - It receives security fixes only, and reaches end of life when 1.0.0 is
released. Pins such as
pyeconomics<1keep working. - 0.2.0 to 0.2.5 log the FRED API key at DEBUG level. Upgrade to 0.2.6 and rotate any key those versions used: see advisory GHSA-j6rp-vwwv-jrr8.
Not to be confused with
This project is not davidrpugh/pyeconomics
(computational-economics course code from 2013–14) or
pyecon.org (a site teaching Python for economics). The
three share only the name.
Contributing and security
- CONTRIBUTING: setup, DCO sign-off, commit conventions and the model definition of done.
- SECURITY: report a vulnerability privately, never in a public issue.
- Code of Conduct.
- Changelog.
Licence
From 1.0, pyeconomics is licensed under the Apache License 2.0; see also NOTICE. Releases up to and including 0.2.x remain MIT-licensed.
Notices
As is; not investment advice. pyeconomics is for educational and informational use only, and is not registered with any regulator.
CFA® and Chartered Financial Analyst® are trademarks owned by CFA Institute. pyeconomics is not affiliated with, endorsed by, or a Prep Provider of CFA Institute.
1 maintainer
Metadata
1 maintainer
Release files for pyeconomics 1.0.0a2
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 | |
|---|---|---|---|---|
| pyeconomics-1.0.0a2.tar.gz | 635.8 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyeconomics-1.0.0a2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / pyeconomics-1.0.0a2.tar.gz
| Download URL | pyeconomics-1.0.0a2.tar.gz |
|---|---|
| Size | 635.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
89d4796beafe320e2e85e4b9cb27217a74469fe5ca817afd2460a1cfe19f13fd
|
|
BLAKE2b-256 checksum How to use checksums |
8f3ad56a1b0520b5dc652c9836b07408d93fe82447ced748b82cda0e21cd6ead
|
| 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 22, 2026.
Transparency logRelease files / pyeconomics-1.0.0a2-py3-none-any.whl
| Download URL | pyeconomics-1.0.0a2-py3-none-any.whl |
|---|---|
| Size | 799.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
be14850478dcede334b666691f9c674ffdb5a4dfcd242622eceb7cebe623d00e
|
|
BLAKE2b-256 checksum How to use checksums |
bd234ee521a5bf699cc2fb950cb22ca5002ece24a9d0b09f6a5346f0b2442d94
|
| 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 22, 2026.
Transparency logSecurity for pyeconomics 1.0.0a2
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 2 files in this release have been uploaded with provenance metadata.
Attestation for pyeconomics-1.0.0a2.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 22, 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.
