{"id":30307354,"url":"https://github.com/quantdevjayson/quantumfx-engine","last_synced_at":"2025-08-17T10:45:50.182Z","repository":{"id":308288711,"uuid":"1032276767","full_name":"QuantDevJayson/quantumfx-engine","owner":"QuantDevJayson","description":"The next-generation open-source platform for quantitative FX risk modeling, scenario analysis, and regulatory stress testing.","archived":false,"fork":false,"pushed_at":"2025-08-05T05:23:21.000Z","size":56,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-05T06:29:51.534Z","etag":null,"topics":["api-integration","backtesting-engine","bau","bau-risk-metrics","cvar","ewma-var","fx","fx-models","garch-model","model-calibration","neural-sde","quantum-machine-learning","regime-switching","sabr","scenario-testing","stochastic-local-volatility","var"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/QuantDevJayson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-05T04:46:16.000Z","updated_at":"2025-08-05T05:35:53.000Z","dependencies_parsed_at":"2025-08-05T06:39:57.206Z","dependency_job_id":null,"html_url":"https://github.com/QuantDevJayson/quantumfx-engine","commit_stats":null,"previous_names":["quantdevjayson/quantumfx-engine"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/QuantDevJayson/quantumfx-engine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QuantDevJayson%2Fquantumfx-engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QuantDevJayson%2Fquantumfx-engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QuantDevJayson%2Fquantumfx-engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QuantDevJayson%2Fquantumfx-engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/QuantDevJayson","download_url":"https://codeload.github.com/QuantDevJayson/quantumfx-engine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QuantDevJayson%2Fquantumfx-engine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270837454,"owners_count":24654386,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-integration","backtesting-engine","bau","bau-risk-metrics","cvar","ewma-var","fx","fx-models","garch-model","model-calibration","neural-sde","quantum-machine-learning","regime-switching","sabr","scenario-testing","stochastic-local-volatility","var"],"created_at":"2025-08-17T10:45:32.560Z","updated_at":"2025-08-17T10:45:50.152Z","avatar_url":"https://github.com/QuantDevJayson.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QuantumFX: Modular, High-Performance FX Risk Analytics \u0026 Scenario Engine\r\n\r\n### The next-generation open-source platform for quantitative FX risk modeling, scenario analysis, and regulatory stress testing.\r\n---\r\nNote: This is an extract of a live, ongoing project for advanced FX risk management. The codebase is actively developed and extended with new features, analytics, and integrations.\r\n\r\nThis project provides a highly modular, high-performance framework for developing, maintaining, and validating advanced FX risk models. Each domain (models, scenario_modelling, stress_testing, bau_metrics, backtesting, api, reporting, streamlit_app) is strictly separated for maintainability and scalability. Scenario analysis is parallelized for large-scale, real-time risk analytics.\r\n\r\n## Why BAU Risk Metrics?\r\n**Business-As-Usual (BAU) risk metrics** are essential for monitoring and managing FX risk under normal market conditions. They provide a quantitative foundation for day-to-day risk oversight, including measures such as Value at Risk (VaR) and Expected Shortfall. BAU metrics help institutions:\r\n- Detect and control risk exposures before they escalate\r\n- Satisfy regulatory requirements for ongoing risk management\r\n- Benchmark performance and risk across portfolios\r\nBy integrating BAU metrics, QuantumFX ensures robust, real-time risk monitoring as a core part of the risk management workflow.\r\n\r\nIt includes:\r\n\r\n- **Scenario Modelling**\r\n- **Stress Testing**\r\n- **BAU Risk Metrics**\r\n- **Back-testing \u0026 Calibration**\r\n- **Multi-currency Portfolio Support**\r\n- **API Integration (FastAPI)**\r\n- **Advanced Reporting \u0026 Visualization**\r\n\r\n## Features\r\n- Strictly modular, extensible architecture\r\n- Production-ready code structure\r\n- Back-testing and calibration for accuracy and compliance\r\n- Designed for regulatory standards\r\n- Portfolio-level stress testing and scenario analysis (parallelized for high performance)\r\n- Live REST API endpoints for model simulation and portfolio valuation\r\n- YAML-based configuration for flexible workflows\r\n\r\n## Structure\r\n- `fx_risk/models/` — Core model definitions (e.g., `fx_model.py`, `heston_model.py`), portfolio logic (`portfolio.py`), and configuration loader (`config_loader.py`).\r\n- `fx_risk/scenario_modelling/` — Scenario generation and management (e.g., `scenario_generator.py`).\r\n- `fx_risk/stress_testing/` — Stress test modules (e.g., `stress_test.py`).\r\n- `fx_risk/bau_metrics/` — Business-as-usual risk metrics (e.g., `metrics.py`).\r\n- `fx_risk/backtesting/` — Back-testing and calibration tools (e.g., `backtest.py`).\r\n- `fx_risk/api/` — REST API server (`server.py`) for integration and automation.\r\n- `fx_risk/reporting/` — Reporting and visualization utilities (e.g., `report.py`).\r\n- `fx_risk/streamlit_app.py` — Interactive Streamlit visualization UI for simulation, portfolio analytics, and scenario analysis.\r\n- `config.yaml` — Example YAML configuration for model parameters.\r\n- `requirements.txt` — All Python dependencies for production deployment.\r\n\r\n## Getting Started\r\n1. Install dependencies: `pip install -r requirements.txt`\r\n2. Explore all modules in `fx_risk/` (see structure above for file-level details).\r\n3. Run tests: `pytest` (all modules are covered by unit tests for production reliability).\r\n4. Launch the API: `uvicorn fx_risk.api.server:app --reload` (for RESTful integration).\r\n5. Launch the Streamlit app for interactive visualization: `streamlit run fx_risk/streamlit_app.py`.\r\n6. Edit `config.yaml` to customize model parameters for your use case.\r\n\r\n## Supported FX Risk Models\r\n\r\nQuantumFX supports a wide range of advanced and research-grade FX risk models. The following models are available for simulation and analytics in the Streamlit dashboard:\r\n\r\n- Heston\r\n- Black-Scholes\r\n- Jump-Diffusion\r\n- GARCH(1,1)\r\n- SABR (coming soon)\r\n- Regime-Switching (coming soon)\r\n- Stochastic Local Volatility (SLV) (coming soon)\r\n- Copula (coming soon)\r\n- Neural SDE (coming soon)\r\n- Rough Volatility (coming soon)\r\n\r\nAll models are accessible from the sidebar dropdown in the Streamlit app. Models marked \"coming soon\" are included for roadmap visibility and will be enabled in future releases.\r\n\r\n## Screenshots\r\n\r\nBelow are screenshots of the QuantumFX Streamlit dashboard, demonstrating the model selection, analytics, and visualization features:\r\n\r\n\r\n\u003cimg width=\"870\" height=\"422\" alt=\"quantumfx-model-scenario-engine\" src=\"https://github.com/user-attachments/assets/8bbc811e-ec1a-4e58-825d-ca313201829b\" /\u003e\r\n\r\n---\r\n\r\n\u003cimg width=\"870\" height=\"422\" alt=\"quantumfx-model-scenario-engine\" src=\"https://github.com/user-attachments/assets/daeb181a-75dd-46da-b132-006fcf27e6b8\" /\u003e\r\n\r\n---\r\n\r\n\u003cimg width=\"592\" height=\"373\" alt=\"quantumfx-simulated-garch\" src=\"https://github.com/user-attachments/assets/609f0c74-cb67-4269-bb0f-a2ed41d96c53\" /\u003e\r\n\r\n---\r\n\r\n\u003cimg width=\"875\" height=\"419\" alt=\"quantumfx-interpret\" src=\"https://github.com/user-attachments/assets/fa3eca1b-c3da-4803-b9c6-956686b88796\" /\u003e\r\n\r\n---\r\n\r\n\u003cimg width=\"704\" height=\"450\" alt=\"quantumfx-ewma-var-exceedances\" src=\"https://github.com/user-attachments/assets/fa98af62-ddf5-4016-8142-8c2cd2df9d8a\" /\u003e\r\n\r\n---\r\n\r\n## Contributing\r\nThis project is under active development by the author and contributors. Thus, new features and improvements are added regularly.\r\n\r\n## Visualization\r\nThe Streamlit app (`fx_risk/streamlit_app.py`) provides an interactive UI for:\r\n- Simulating FX model paths\r\n- Valuing and analyzing multi-currency portfolios\r\n- Running portfolio stress tests and scenario analysis\r\nLaunch with:\r\n```\r\nstreamlit run fx_risk/streamlit_app.py\r\n```\r\n\r\n\r\n**Disclaimer**: Majority of features have been truncated by the original author for brevity and clarity.\r\n\r\n\r\n\r\n### Feel Free to Contact Original Author\r\n\r\n- **GitHub**: [QuantDevJayson](https://github.com/QuantDevJayson)  \r\n- **PyPI**: [jayson.ashioya](https://pypi.org/user/jayson.ashioya)  \r\n- **LinkedIn**: [Jayson Ashioya](https://www.linkedin.com/in/jayson-ashioya-c-082814176/)\r\n\r\n\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquantdevjayson%2Fquantumfx-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquantdevjayson%2Fquantumfx-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquantdevjayson%2Fquantumfx-engine/lists"}