The repository or configuration that created this release differ from a previous release. View details.
This release is a pre-release and may not be stable for production use.
pyeconomics
Status: 1.0.0a1 is an alpha pre-release on PyPI. Install explicitly with
pip install --pre pyeconomics==1.0.0a1(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 32 tested, cited, data-free economics and finance model
families across 11 domains: foundations, fixed income, derivatives,
international, equity, corporate, accounting, portfolio, performance, risk
and econometrics. 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. Install optional OLS and plotting support
with pip install --pre "pyeconomics[econometrics,plot]==1.0.0a1".
This alpha replaces the 0.2.x API. Live data, monetary-policy rules, 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.0a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Change of provenance
The repository or configuration that created these release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| pyeconomics-1.0.0a1.tar.gz | 229.9 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyeconomics-1.0.0a1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 524.0 kB
Release files / pyeconomics-1.0.0a1.tar.gz
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | pyeconomics-1.0.0a1.tar.gz |
|---|---|
| Size | 229.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2e4343e4a475d4a248d68914b211639f272bf20cb54cc57e18cad99faea99604
|
|
BLAKE2b-256 checksum How to use checksums |
5ef326b63f37596f960042ca3d4b61a1502e88fd53e6de7538bf2746ba827b34
|
| 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 14, 2026.
Transparency logRelease files / pyeconomics-1.0.0a1-py3-none-any.whl
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | pyeconomics-1.0.0a1-py3-none-any.whl |
|---|---|
| Size | 294.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5c053212b3c3b84decd6da5f61ff9b587532d9cc1f7102d307e5207f0edd4895
|
|
BLAKE2b-256 checksum How to use checksums |
657e580437d9523e4e156ec40b508c19dcd16054cc9f3801ddcd063ebda0681a
|
| 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 14, 2026.
Transparency logSecurity for pyeconomics 1.0.0a1
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.
Change of provenance
The repository that created this release differs from a previous release.
While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.
Repository
- Removed 0.2.6 GitHub: nathanramoscfa/pyeconomics
- Added 1.0.0a1 GitHub: pyeconomics-dev/pyeconomics
Attestation for pyeconomics-1.0.0a1.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 14, 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.
