vnpy / First Run

vnpy 首次运行:启动 VeighNa Trader

安装 vnpy 后,按官方 run.py 示例创建启动脚本,初始化事件引擎与主引擎,添加交易接口与策略应用,即可启动 VeighNa Trader 主窗口。

前置:已安装 vnpy入口:run.py启动:python run.py
创建 run.py官方示例脚本
初始化引擎EventEngine + MainEngine
添加 gateway/app如 CtpGateway / CtaStrategyApp
启动主窗口python run.py
基于 vnpy 官方 README run.py 示例的首次启动流程示意。
Official example

官方 run.py 示例

以下为 vnpy 官方 README 提供的首次运行脚本(2026-08 核验)。

from vnpy.event import EventEngine
from vnpy.trader.engine import MainEngine
from vnpy.trader.ui import MainWindow, create_qapp
from vnpy_ctp import CtpGateway
from vnpy_ctastrategy import CtaStrategyApp
from vnpy_ctabacktester import CtaBacktesterApp

def main():
    # Start VeighNa Trader
    qapp = create_qapp()
    event_engine = EventEngine()
    main_engine = MainEngine(event_engine)
    main_engine.add_gateway(CtpGateway)
    main_engine.add_app(CtaStrategyApp)
    main_engine.add_app(CtaBacktesterApp)
    main_window = MainWindow(main_engine, event_engine)
    main_window.showMaximized()
    qapp.exec()

if __name__ == "__main__":
    main()
运行:在脚本目录打开命令行(Windows 用 CMD/PowerShell),执行 python run.py 启动 VeighNa Trader。
Steps

启动四步

按官方示例拆解,便于理解每一步的作用。

1. 创建 QApplication

调用 create_qapp() 创建图形界面应用。

2. 初始化引擎

创建 EventEngine 事件引擎与 MainEngine 主引擎。

3. 添加接口与应用

add_gateway 接入交易接口(如 CtpGateway),add_app 添加策略应用(如 CtaStrategyApp、CtaBacktesterApp)。

4. 启动主窗口

创建 MainWindow 并最大化显示,运行 python run.py 进入 VeighNa Trader。

边界:启动成功仅表示程序运行;行情与交易连通取决于接口配置、账号授权与网络,本站不承诺。
Next

首次运行后做什么?

接入接口后即可编写与回测 CTA 策略,或配置数据服务与数据库。

跑起来之后呢?

vnpy 需要自行维护接口、数据与策略环境。想用一句话直接发起量化研究任务,可看 EasyClaw 量化 Skill 路线。