jh-quant 0.1.0__tar.gz

jh_quant-0.1.0/.gitignore

@@ -0,0 +1,28 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+CLAUDE.md 
+
+test.py
+test_*
+
+*.db
+
+.claude
+specs
+
+*db-shm
+*db-wal
+
+
+.env
+
+*.log

jh_quant-0.1.0/LICENCE

@@ -0,0 +1,26 @@
+jh_quant - 量化交易研究平台
+Copyright (C) 2026 jh_quant
+
+本程序是自由软件：您可以在自由软件基金会发布的 GNU Affero 通用公共许可证
+（AGPL）第三版或（您可选的）任何更新版本的条款下重新分发和/或修改本程序。
+
+分发本程序的目的是希望它有用，但没有任何担保；甚至没有对适销性或特定用途
+适用性的暗示担保。更多详细信息请参见 GNU Affero 通用公共许可证。
+
+您应该已随本程序收到 GNU Affero 通用公共许可证的副本。如果没有，
+请参见 <https://www.gnu.org/licenses/agpl-3.0.html>。
+
+-----------------------------------------------------------------------
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.

jh_quant-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: jh-quant
+Version: 0.1.0
+Summary: Add your description here
+License-File: LICENCE
+Requires-Python: >=3.10
+Requires-Dist: croniter>=1.4.0
+Requires-Dist: dotenv>=0.9.9
+Requires-Dist: duckdb>=1.4.4
+Requires-Dist: fastapi-mcp>=0.4.0
+Requires-Dist: fastapi>=0.116.1
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: ipywidgets>=8.1.8
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: joblib>=1.4.0
+Requires-Dist: jupyterlab>=4.5.6
+Requires-Dist: matplotlib>=3.10.8
+Requires-Dist: notebook>=7.5.5
+Requires-Dist: pandas>=2.3.3
+Requires-Dist: polars>=1.0.0
+Requires-Dist: psycopg[binary]>=3.2.9
+Requires-Dist: pyarrow>=23.0.1
+Requires-Dist: pydantic>=2.13.3
+Requires-Dist: pywebview>=6.1
+Requires-Dist: quantstats>=0.0.81
+Requires-Dist: rich>=14.3.2
+Requires-Dist: riskfolio-lib>=7.0.1
+Requires-Dist: scipy>=1.15.3
+Requires-Dist: tortoise-orm>=0.25.1
+Requires-Dist: uvicorn>=0.35.0
+Description-Content-Type: text/markdown
+
+# JH_QUANT
+
+![banner](assets/banner_sm.png)
+量化交易研究与执行平台。支持：**免费数据获取**、**回测**、**因子计算**、 **模拟交易**、**组合优化**、**可视化仪表盘**
+
+- **官网**: https://jiuhuang.xyz
+- **文档**: https://doc.jiuhuang.xyz
+
+## 模块
+
+| 模块                           | 说明                                                 | 文档                              |
+| ------------------------------ | ---------------------------------------------------- | --------------------------------- |
+| [data](docs/data.md)           | 多种数据获取，兼容akshare和tushare数据类型及调用风格 | [README](docs/data/index.md)      |
+| [trading](docs/trading.md)     | 交易运行层，模拟(实时)交易与会话编排                 | [README](docs/trading/index.md)   |
+| [backtest](docs/backtest.md)   | 回测引擎，快速策略验证，多种内置策略                 | [README](docs/backtest/index.md)  |
+| [factors](docs/factors.md)     | 因子计算，内置多种因子模型                           | [README](docs/factors/index.md)   |
+| [dashboard](docs/dashboard.md) | PyWebView可视化仪表盘                                | [README](docs/dashboard/index.md) |
+
+## 快速开始
+
+### 安装
+
+```bash
+pip install jh_quant
+```
+
+### 数据获取
+
+```python
+import os
+from jh_quant.data import JHData, DataTypes
+
+load_dotenv()   # 读取.env文件, 必须设置JIUHUANG_API_KEY变量
+
+jh = JHData(apt_key=os.getenv("JIUHUANG_API_KEY"))
+stock_price = jh.get_data(
+    DataTypes.AK_STOCK_ZH_A_HIST_QFQ,  #akshare日线前复盘数据
+    symbol="000001",
+    start="2025-01-01",
+    end="2025-12-10",
+)
+```
+
+**重要**
+
+> `jh_quant` 的数据获取**并非**像 [akshare](https://github.com/akfamily/akshare) 那样需要实时抓取数据。  
+> `jh_quant` 仅做了对 [akshare](https://github.com/akfamily/akshare) 数据类型的兼容，数据真实来源为：[JiuHuang API](https://jiuhuang.xyz)
+
+### 实时模拟交易
+
+**jh_quant**支持同时开启多个模拟交易会话，每个会话对应一个模拟账户, 下面是示例运行:
+
+```bash
+python run_paper.py
+```
+*run_paper.py*的完整代码参考本repo根目录的[run_paper.py](./run_paper.py)
+
+在回填模式下（可以通过`enable_backfill=False`关闭），会完成历史交易模拟，并在本地开启服务
+
+**开启控制台仪表盘**
+开启本地服务之后, 可以通过如下代码开启控制台仪表盘
+```python
+from jh_quant.dashboard import display_trading
+
+display_trading()
+```
+
+![dashboard](assets/screenshots/gateway_sessions_sm.png)
+
+## License
+
+This project is licensed under the AGPL-3.0 License - see the [LICENSE](LICENSE) file for details.

jh_quant-0.1.0/README.md

@@ -0,0 +1,72 @@
+# JH_QUANT
+
+![banner](assets/banner_sm.png)
+量化交易研究与执行平台。支持：**免费数据获取**、**回测**、**因子计算**、 **模拟交易**、**组合优化**、**可视化仪表盘**
+
+- **官网**: https://jiuhuang.xyz
+- **文档**: https://doc.jiuhuang.xyz
+
+## 模块
+
+| 模块                           | 说明                                                 | 文档                              |
+| ------------------------------ | ---------------------------------------------------- | --------------------------------- |
+| [data](docs/data.md)           | 多种数据获取，兼容akshare和tushare数据类型及调用风格 | [README](docs/data/index.md)      |
+| [trading](docs/trading.md)     | 交易运行层，模拟(实时)交易与会话编排                 | [README](docs/trading/index.md)   |
+| [backtest](docs/backtest.md)   | 回测引擎，快速策略验证，多种内置策略                 | [README](docs/backtest/index.md)  |
+| [factors](docs/factors.md)     | 因子计算，内置多种因子模型                           | [README](docs/factors/index.md)   |
+| [dashboard](docs/dashboard.md) | PyWebView可视化仪表盘                                | [README](docs/dashboard/index.md) |
+
+## 快速开始
+
+### 安装
+
+```bash
+pip install jh_quant
+```
+
+### 数据获取
+
+```python
+import os
+from jh_quant.data import JHData, DataTypes
+
+load_dotenv()   # 读取.env文件, 必须设置JIUHUANG_API_KEY变量
+
+jh = JHData(apt_key=os.getenv("JIUHUANG_API_KEY"))
+stock_price = jh.get_data(
+    DataTypes.AK_STOCK_ZH_A_HIST_QFQ,  #akshare日线前复盘数据
+    symbol="000001",
+    start="2025-01-01",
+    end="2025-12-10",
+)
+```
+
+**重要**
+
+> `jh_quant` 的数据获取**并非**像 [akshare](https://github.com/akfamily/akshare) 那样需要实时抓取数据。  
+> `jh_quant` 仅做了对 [akshare](https://github.com/akfamily/akshare) 数据类型的兼容，数据真实来源为：[JiuHuang API](https://jiuhuang.xyz)
+
+### 实时模拟交易
+
+**jh_quant**支持同时开启多个模拟交易会话，每个会话对应一个模拟账户, 下面是示例运行:
+
+```bash
+python run_paper.py
+```
+*run_paper.py*的完整代码参考本repo根目录的[run_paper.py](./run_paper.py)
+
+在回填模式下（可以通过`enable_backfill=False`关闭），会完成历史交易模拟，并在本地开启服务
+
+**开启控制台仪表盘**
+开启本地服务之后, 可以通过如下代码开启控制台仪表盘
+```python
+from jh_quant.dashboard import display_trading
+
+display_trading()
+```
+
+![dashboard](assets/screenshots/gateway_sessions_sm.png)
+
+## License
+
+This project is licensed under the AGPL-3.0 License - see the [LICENSE](LICENSE) file for details.