English Français العربية

pyeconomics

Registre officiel Finance et paiements

Tested, cited economics and finance models and data, with a provenance manifest per result.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package pyeconomics
Claude Code 
claude mcp add pyeconomics -- uvx pyeconomics==1.0.0b1 mcp
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pyeconomics": {
            "command": "uvx",
            "args": [
                "pyeconomics==1.0.0b1",
                "mcp"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. pyeconomics
  2. pyeconomics 0.2.x
  3. Not to be confused with
  4. Contributing and security
  5. Licence
  6. Notices

pyeconomics

Status: 1.0.0b1 is a beta pre-release on PyPI. Install explicitly with pip install --pre pyeconomics==1.0.0b1 (Python 3.12 or later). Plain pip install pyeconomics still 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. Every model is served identically through the Python API, the pyeconomics command line, the REST API (pyeconomics serve), the MCP server (pyeconomics mcp) and tabular or reproducibility-bundle exports. 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 beta release notes for the shipped surfaces and known limitations. See the CLI guide, REST API guide, MCP server guide, exports guide, AI narrative guide, data guide and keys guide to get started. Install optional econometrics, plotting, REST API and MCP support with pip install --pre "pyeconomics[econometrics,plot,server,mcp]==1.0.0b1", or run the MCP server directly with uvx --from "pyeconomics[mcp]==1.0.0b1" pyeconomics mcp.

This beta replaces the 0.2.x API and adds the command line, exports and reproducibility bundles, REST API, MCP server and optional AI narrative on top of the model engine and data platform. The web app arrives in Phase 5; 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.x branch, 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<1 keep 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

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.

Questions fréquentes

Qu'est-ce que pyeconomics ?

Tested, cited economics and finance models and data, with a provenance manifest per result.

Comment installer pyeconomics ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add pyeconomics -- uvx pyeconomics==1.0.0b1 mcp. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour pyeconomics ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

pyeconomics est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient pyeconomics ?

Il est publié par pyeconomics-dev. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.