AsyncTrader

A quantitative trading automation tool powered by LangChain + OpenAI. 基于 LangChain 和 OpenAI 的量化交易自动化工具。

---

What is this? / 这是什么？

English: AsyncTrader uses large language models (LLM) to automatically generate, backtest, and optimize quantitative trading strategies. It integrates with Freqtrade (crypto), AkShare (China financial data), and Vnpy (China quant trading). Version 2.0 adds a modern web UI so you can do everything in the browser.

中文： AsyncTrader 利用大语言模型自动生成、回测和优化量化交易策略。目前已集成 Freqtrade（加密货币）、AkShare（中国金融数据）和 Vnpy（中国量化交易）。v2.0 新增了现代化 Web 界面，所有操作都可以在浏览器中完成。

---

Quick Start / 快速开始

1. Install Dependencies / 安装依赖

pip install -r requirements.txt

Core packages / 核心包：fastapi, uvicorn, langchain>=1.0, langchain-openai, chromadb, akshare

2. Start the Server / 启动服务

uvicorn app.main:app --host 0.0.0.0 --port 5000

Then open your browser and visit / 然后打开浏览器访问：/

3. Configure API Key / 配置 API Key

On the Configuration page, enter your OpenAI API Key and click "Save Configuration". The page will show "Ready" when the LLM is active.

在 系统配置 页面，输入你的 OpenAI API Key，点击 "保存配置"。配置成功后状态会显示 "就绪"。

---

Web UI Guide / 界面功能说明

Click the 中文/English button at the bottom of the sidebar to switch language.

点击侧边栏底部的 中文/English 按钮可切换语言。

Page / 页面	What it does / 功能
Configuration / 系统配置	Set OpenAI API Key, model, and temperature. / 设置 OpenAI API Key、模型和温度参数。
Strategy Generator / 策略生成器	Describe your strategy in plain language, AI generates Freqtrade or Vnpy code. / 用自然语言描述策略，AI 自动生成 Freqtrade 或 Vnpy 策略代码。
Web Extractor / 网页策略提取	Paste a URL containing a trading strategy, AI extracts the logic. / 粘贴包含交易策略的网页链接，AI 自动提取策略逻辑。
Data Query / 数据查询	Ask for financial data in natural language (e.g., "Get SHFE copper futures daily data"). Powered by AkShare. / 用自然语言查询金融数据（例如：获取上期所铜期货日线数据）。底层使用 AkShare。
Doc Q&A / 文档问答	Build a knowledge base from markdown docs, then ask questions. / 从 Markdown 文档构建知识库，然后进行问答。

---

API Endpoints / API 接口

Method	Endpoint	Description / 说明
GET	/api/llm/status	Check LLM status / 检查大模型状态
POST	/api/llm/configure	Configure API Key & model / 配置 API Key 和模型
POST	/api/strategy/generate	Generate strategy code / 生成策略代码
POST	/api/strategy/extract	Extract strategy from URL / 从网页提取策略
POST	/api/data/query	Query AkShare data / 查询 AkShare 数据
POST	/api/chat/build	Build document index / 构建文档索引
POST	/api/chat/ask	Ask document question / 文档问答
GET	/api/systems/status	Check external systems / 检查外部系统可用性

---

Architecture / 项目架构

app/
  main.py              # FastAPI entrypoint / FastAPI 入口
  routers/             # API routes / API 路由
  services/            # Business logic / 业务逻辑
  static/              # Web frontend / Web 前端

trading_system/
  base.py              # LLMManager / 大模型配置管理
  tools.py             # Strategy & web extraction tools / 策略和网页提取工具
  akshare_tools.py     # AkShare data query / AkShare 数据查询
  rag.py               # Document Q&A chain / 文档问答链

---

Notes / 注意事项

1. API Key required / 需要 API Key: All AI features require a valid OpenAI API Key. / 所有 AI 功能都需要有效的 OpenAI API Key。
2. External systems / 外部系统: Freqtrade and Vnpy require separate installation. The UI shows their availability status. / Freqtrade 和 Vnpy 需要单独安装，界面会显示它们的可用状态。
3. Doc Q&A / 文档问答: Requires markdown (.md) files in the specified docs folder. / 需要在指定文档文件夹中放置 Markdown 文件。
4. LangChain version / LangChain 版本: v2.0 is based on LangChain 1.0+. It is not compatible with the old 0.0.x API. / v2.0 基于 LangChain 1.0+，与旧版 0.0.x API 不兼容。

---

Legacy Docs / 旧版文档

The original CLI-based workflow documentation is preserved in docs/:

• docs/freqtrade_system.md
• docs/akshare_system.md
• docs/vnpy_system.md

旧版基于命令行的使用文档保留在 docs/ 目录下。