Metadata-Version: 2.4
Name: fwquant
Version: 1.0.45
Summary: 一个功能完整的福纹量化交易系统，支持多交易所连接、策略回测与实盘交易
Home-page: https://github.com/fwquant/fwquant
Author: fwquant
Author-email: fwquant <fuwenquant@gmail.com>
Maintainer: fwquant
Maintainer-email: fwquant <fuwenquant@gmail.com>
Project-URL: Homepage, https://www.yaluo.com
Project-URL: Repository, https://github.com/fwquant/fwquant
Project-URL: Documentation, https://github.com/fwquant/fwquant/wiki
Keywords: 量化交易,fwquant,crypto,bot,trading
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: setuptools>=70.0
Requires-Dist: six>=1.16
Requires-Dist: typing_extensions>=4.12
Requires-Dist: pandas<3.0,>=2.0
Requires-Dist: numpy<3.0,>=1.24
Requires-Dist: numba>=0.60.0
Requires-Dist: pandas-stubs
Requires-Dist: TA-Lib
Requires-Dist: QuantStats>=0.0.77
Requires-Dist: backtrader>=1.9.78
Requires-Dist: futu-api
Requires-Dist: akshare>=1.18
Requires-Dist: tqsdk>=3.9
Requires-Dist: tushare
Requires-Dist: composio_crewai
Requires-Dist: loguru>=0.7.2
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests>=2.31
Requires-Dist: tabulate>=0.9.0
Requires-Dist: tzlocal
Requires-Dist: pytz
Requires-Dist: tzdata
Requires-Dist: aiohttp>=3.9
Requires-Dist: aiohappyeyeballs>=2.6
Provides-Extra: web
Requires-Dist: fastapi>=0.115; extra == "web"
Requires-Dist: uvicorn>=0.25; extra == "web"
Requires-Dist: Flask>=3.0; extra == "web"
Requires-Dist: flask_cors>=6.0; extra == "web"
Requires-Dist: Werkzeug>=3.0; extra == "web"
Requires-Dist: starlette==0.50.0; extra == "web"
Provides-Extra: gui
Requires-Dist: pyqtgraph>=0.13; extra == "gui"
Requires-Dist: qdarkstyle>=3.1; extra == "gui"
Requires-Dist: qtpy>=2.4; extra == "gui"
Requires-Dist: matplotlib>=3.8; extra == "gui"
Requires-Dist: plotly>=6.5; extra == "gui"
Requires-Dist: seaborn>=0.13; extra == "gui"
Provides-Extra: ai
Requires-Dist: crewai; extra == "ai"
Requires-Dist: langchain>=0.1; extra == "ai"
Requires-Dist: langchain-openai>=0.1; extra == "ai"
Requires-Dist: litellm==1.83.7; extra == "ai"
Provides-Extra: task
Requires-Dist: celery>=5.3; extra == "task"
Requires-Dist: celery-types; extra == "task"
Requires-Dist: django-celery-beat; extra == "task"
Requires-Dist: redis>=7.0; extra == "task"
Provides-Extra: django
Requires-Dist: Django>=5.0; extra == "django"
Requires-Dist: djangorestframework; extra == "django"
Requires-Dist: django-timezone-field; extra == "django"
Requires-Dist: django-crontab; extra == "django"
Provides-Extra: macos
Requires-Dist: pyobjc-core; sys_platform == "darwin" and extra == "macos"
Requires-Dist: pyobjc-framework-Cocoa; sys_platform == "darwin" and extra == "macos"
Requires-Dist: pyobjc-framework-Quartz; sys_platform == "darwin" and extra == "macos"
Requires-Dist: pyobjc-framework-Security; sys_platform == "darwin" and extra == "macos"
Requires-Dist: pywebview; sys_platform == "darwin" and extra == "macos"
Requires-Dist: PySide6; sys_platform == "darwin" and extra == "macos"
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: isort; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-html; extra == "dev"
Provides-Extra: full
Requires-Dist: fwquant[ai,dev,django,gui,macos,task,web]; extra == "full"
Dynamic: author
Dynamic: home-page
Dynamic: maintainer
Dynamic: requires-python

# FWQuant

一个从 0 到 1 完全自建的量化交易平台。

<div style="text-align: center;">
  <img src="fuwen.jpg" alt="fuwen">
</div>



## 功能特性

- **fwquant**: 量化平台主框架，包含以下模块：
    - **fwdata**: 量化数据框架，用于处理量化数据并提供数据接口
    - **fwweb**: 量化 Web 框架，用于提供量化平台的 Web 界面
    - **fwengine**: 量化引擎，负责执行量化策略
    - **fuwen_adaptor**: 量化交易框架，用于连接交易接口、处理交易数据并执行交易指令

## 安装方法

```bash
# 使用 uv 安装（推荐）
uv pip install fwquant -U

# 开发模式安装
git clone https://github.com/fwquant/fwquant.git
cd fwquant
uv pip install -e .
```

## 快速开始

```bash
# 启动 Web 服务
fwquant web run

# 查看可用命令
fwquant --help
```

## 📖 文档入口

### 👥 用户指南

| 文档名称        | 路径                               | 说明              |
|:------------|:---------------------------------|:----------------|
| **📦 安装指南** | **[docs/用户安装.md](docs/用户安装.md)** | **环境准备与安装步骤**   |
| **🚀 运行服务** | **[docs/运行服务.md](docs/运行服务.md)** | **服务启动说明（最常用）** |
| **💡 帮助文档** | [docs/help.md](docs/help.md)     | **使用帮助与常见问题**   |

### 💻 程序开发

| 文档名称          | 路径                                         | 说明               |
|:--------------|:-------------------------------------------|:-----------------|
| **📦 上传打包指南** | **[docs/上传打包_pypi.md](docs/上传打包_pypi.md)** | **PyPI 打包与上传**   |
| **📝 开发日志**   | [docs/开发日志.md](docs/开发日志.md)               | **开发进度记录**       |
| **📚 模块文档**   | [docs/module_docs/](docs/module_docs/)     | **核心模块说明（共14个）** |

### 🛠️ 综合运维

| 文档名称        | 路径                               | 说明         |
|:------------|:---------------------------------|:-----------|
| **🔧 运维手册** | **[docs/运维手册.md](docs/运维手册.md)** | **运维部署指南** |

## 致谢

感谢所有开源社区的贡献，使本项目的开发成为可能。

### 🛠️ 核心技术栈

本框架构建于以下核心技术之上：

- **Python 3.12+**: 现代编程语言，提供优秀的性能和开发体验
- **uv**: 新一代 Python 包管理器，提供极速的依赖解析和环境管理
- **FastAPI**: 高性能 Web 框架，用于构建量化平台 API
- **SQLAlchemy**: 强大的 ORM 框架，管理交易数据持久化
- **Pydantic**: 数据验证和序列化，确保数据完整性
- **Pandas/Numpy**: 量化数据分析的核心工具库
- **TA-Lib**: 技术指标计算库，支持上百种经典技术指标
- **websockets**: 实时行情推送和订单更新
- **Click**: 命令行接口框架，提供便捷的 CLI 工具
- **VN.PY**: 量化交易框架，提供交易接口和事件驱动架构的设计灵感
