English Français العربية

pyeconomics

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو pyeconomics؟

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

كيف أثبّت pyeconomics؟

يعمل على جهازك. في Claude Code: claude mcp add pyeconomics -- uvx pyeconomics==1.0.0b1 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج pyeconomics إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل pyeconomics مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون pyeconomics؟

ينشره pyeconomics-dev. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.