Signed-off-by: TIANHE <TIANHE@GMAIL.COM>
This commit is contained in:
TIANHE
2025-12-30 16:28:13 +08:00
parent 614243bf0f
commit c6044242c5
5 changed files with 1510 additions and 0 deletions
+9
View File
@@ -5,6 +5,15 @@
<h1 align="center">QuantDinger</h1>
<div align="center">
<a href="README.md">🇺🇸 English</a> |
<a href="README_CN.md">🇨🇳 简体中文</a> |
<a href="README_TW.md">🇹🇼 繁體中文</a> |
<a href="README_JA.md">🇯🇵 日本語</a> |
<a href="README_KO.md">🇰🇷 한국어</a>
</div>
<br/>
<p align="center">
<strong>🤖 AI-Native · 🔒 Privacy-First · 🚀 All-in-One Quant Workspace</strong>
</p>
+379
View File
@@ -0,0 +1,379 @@
<div align="center">
<a href="README.md">🇺🇸 English</a> |
<a href="README_CN.md">🇨🇳 简体中文</a> |
<a href="README_TW.md">🇹🇼 繁體中文</a> |
<a href="README_JA.md">🇯🇵 日本語</a> |
<a href="README_KO.md">🇰🇷 한국어</a>
</div>
<br/>
<div align="center">
<a href="https://github.com/brokermr810/QuantDinger">
<img src="https://ai.quantdinger.com/img/logo.e0f510a8.png" alt="QuantDinger Logo" width="160" height="160">
</a>
<h1 align="center">QuantDinger</h1>
<p align="center">
<strong>🤖 AI 原生 · 🔒 隐私优先 · 🚀 全能量化工作台</strong>
</p>
<p align="center">
<i>下一代本地量化平台:多市场数据、AI 投研、可视化回测与自动交易。</i>
</p>
<p align="center">
<a href="https://www.quantdinger.com"><strong>官网</strong></a> ·
<a href="https://ai.quantdinger.com"><strong>在线演示</strong></a> ·
<a href="https://github.com/brokermr810/QuantDinger/issues"><strong>报告 Bug</strong></a> ·
<a href="https://github.com/brokermr810/QuantDinger/discussions"><strong>讨论区</strong></a>
</p>
<p align="center">
<a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square&logo=apache" alt="License"></a>
<img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python">
<img src="https://img.shields.io/badge/Vue.js-2.x-4FC08D?style=flat-square&logo=vue.js&logoColor=white" alt="Vue">
<img src="https://img.shields.io/badge/Docker-Ready-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker">
<img src="https://img.shields.io/github/stars/brokermr810/QuantDinger?style=flat-square&logo=github" alt="Stars">
</p>
<p align="center">
<a href="https://t.me/worldinbroker"><img src="https://img.shields.io/badge/Telegram-Join%20Chat-26A5E4?style=for-the-badge&logo=telegram" alt="Telegram"></a>
<a href="https://discord.gg/cn6HVE2KC"><img src="https://img.shields.io/badge/Discord-Join%20Server-5865F2?style=for-the-badge&logo=discord" alt="Discord"></a>
<a href="https://x.com/HenryCryption"><img src="https://img.shields.io/badge/X-Follow%20Us-000000?style=for-the-badge&logo=x" alt="X"></a>
</p>
</div>
---
## 📖 简介
**QuantDinger** 是一个专为交易员、研究员和极客设计的**本地优先**(Local-First)量化交易工作台。
与昂贵的 SaaS 平台不同,QuantDinger 将**数据所有权**归还给你。它内置了一个**基于 LLM 的多智能体投研团队**,能够自动从网络收集金融情报,结合本地行情数据,生成专业的分析报告,并与你的策略开发、回测及实盘交易流程无缝集成。
### 核心价值
- **🛡️ 隐私优先**:所有策略、交易日志和 API 密钥都存储在你的本地 SQLite 数据库中。
- **🧠 AI 赋能**:不仅是代码补全,更是真正的 AI 投研分析师(由 OpenRouter/LLM 驱动)。
- **⚡ 多市场支持**:原生支持 **加密货币**、**美股**、**A股/港股**、**外汇** 和 **期货**
- **🔌 开箱即用**:通过 Docker 一键部署。无需复杂的环境配置。
---
## 📸 功能预览
<div align="center">
<h3>📊 专业量化仪表盘</h3>
<p>实时监控市场动态、资产状况和策略状态。</p>
<img src="docs/screenshots/dashboard.png" alt="QuantDinger Dashboard" width="100%" style="border-radius: 10px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);">
</div>
<br/>
<table align="center" width="100%">
<tr>
<td width="50%" align="center" valign="top">
<h3>🤖 AI 深度投研</h3>
<p>多智能体协作进行市场情绪与技术分析。</p>
<img src="docs/screenshots/ai_analysis1.png" alt="AI Market Analysis" style="border-radius: 6px;">
</td>
<td width="50%" align="center" valign="top">
<h3>💬 智能交易助手</h3>
<p>通过自然语言接口获取即时市场洞察。</p>
<img src="docs/screenshots/trading_assistant.png" alt="Trading Assistant" style="border-radius: 6px;">
</td>
</tr>
<tr>
<td width="50%" align="center" valign="top">
<h3>📈 交互式指标分析</h3>
<p>丰富的技术指标库,支持拖拽式分析。</p>
<img src="docs/screenshots/indicator_analysis.png" alt="Indicator Analysis" style="border-radius: 6px;">
</td>
<td width="50%" align="center" valign="top">
<h3>🐍 Python 策略生成</h3>
<p>内置编辑器,支持 AI 辅助策略代码编写。</p>
<img src="docs/screenshots/indicator_creat_python_code.png" alt="Code Generation" style="border-radius: 6px;">
</td>
</tr>
</table>
---
## ✨ 关键特性
### 1. 通用数据引擎
无需再为数据 API 发愁。QuantDinger 采用了强大的数据源工厂模式:
- **加密货币**:**直连交易所 API** 进行交易(支持 10+ 交易所),结合 **CCXT** 获取行情数据(支持 100+ 来源)。
- **股票**:集成 Yahoo Finance、Finnhub、Tiingo (美股) 和 AkShare (A股/港股)。
- **期货/外汇**:支持 OANDA 及主要期货数据源。
- **代理支持**:内置代理配置,适应受限网络环境。
### 2. AI 多智能体投研
你不知疲倦的分析师团队:
- **协调智能体**:拆解任务并管理工作流。
- **搜索智能体**:进行全网搜索(Google/Bing)获取宏观新闻。
- **加密/股票智能体**:专注于特定市场的技术和资金流向分析。
- **报告生成**:自动产出结构化的日报/周报。
### 3. 稳健的策略运行时
- **基于线程的执行器**:独立的线程池管理策略执行。
- **自动恢复**:系统重启后自动恢复运行中的策略。
- **挂单工作线程**:可靠的后台队列确保信号精准执行,防止滑点。
### 4. 现代技术栈
- **后端**Python (Flask) + SQLite + Redis (可选) — 简洁、强大、易扩展。
- **前端**Vue 2 + Ant Design Vue + KlineCharts/ECharts — 响应式且交互丰富。
- **部署**Docker Compose 编排。
---
## 🏦 支持的交易所与返佣
QuantDinger 支持**直连**主要加密货币交易所进行低延迟执行,同时利用 **CCXT** 覆盖广泛的行情数据。
> 💡 **独家福利**:通过下方的合作伙伴链接注册账户,可享受**交易手续费减免**和**独家赠金**。这将在不增加你成本的情况下支持本项目!
| 交易所 | 特点 | 注册福利 |
|:--------:|:---------|:-------------:|
| <img src="https://img.shields.io/badge/Binance-F0B90B?style=for-the-badge&logo=binance&logoColor=white" height="35"/> | 🥇 **全球最大**<br/>现货, 合约, 杠杆 | <a href="https://www.bjwebptyiou.com/join/14449926"><img src="https://img.shields.io/badge/💰_节省_20%25_手续费-00C853?style=for-the-badge" height="35"/></a> |
| <img src="https://img.shields.io/badge/OKX-000000?style=for-the-badge&logo=okx&logoColor=white" height="35"/> | 🚀 **Web3 & 衍生品**<br/>现货, 永续, 期权 | <a href="https://www.bmwweb.ac/referral/earn-together/refer2earn-usdc/claim?hl=zh-CN&ref=GRO_28502_9OSOJ"><img src="https://img.shields.io/badge/🎁_领取盲盒-00C853?style=for-the-badge" height="35"/></a> |
| <img src="https://img.shields.io/badge/Bitget-00C7B1?style=for-the-badge&logoColor=white" height="35"/> | 👥 **社交交易**<br/>跟单交易, 合约 | <a href="https://www.bitget.rocks/zh-CN/referral/register?clacCode=91AWLH0U&from=%2Fzh-CN%2Fevents%2Freferral-all-program&source=events&utmSource=PremierInviter"><img src="https://img.shields.io/badge/🔥_领取赠金-00C853?style=for-the-badge" height="35"/></a> |
<br>
**同时也支持 (直连/CCXT):**
| <img src="https://img.shields.io/badge/Bybit-F7931A?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/Gate.io-17E6A1?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/Kraken-5741D9?style=for-the-badge&logo=kraken&logoColor=white"/> | <img src="https://img.shields.io/badge/KuCoin-24AE8F?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/HTX-1A73E8?style=for-the-badge&logoColor=white"/> |
|:---:|:---:|:---:|:---:|:---:|
---
### 多语言支持
QuantDinger 为全球用户构建,提供全面的国际化支持:
<p>
<img src="https://img.shields.io/badge/🇺🇸_English-Supported-2563EB?style=flat-square" alt="English" />
<img src="https://img.shields.io/badge/🇨🇳_简体中文-Supported-2563EB?style=flat-square" alt="Simplified Chinese" />
<img src="https://img.shields.io/badge/🇹🇼_繁體中文-Supported-2563EB?style=flat-square" alt="Traditional Chinese" />
<img src="https://img.shields.io/badge/🇯🇵_日本語-Supported-2563EB?style=flat-square" alt="Japanese" />
<img src="https://img.shields.io/badge/🇰🇷_한국어-Supported-2563EB?style=flat-square" alt="Korean" />
<img src="https://img.shields.io/badge/🇩🇪_Deutsch-Supported-2563EB?style=flat-square" alt="German" />
<img src="https://img.shields.io/badge/🇫🇷_Français-Supported-2563EB?style=flat-square" alt="French" />
<img src="https://img.shields.io/badge/🇹🇭_ไทย-Supported-2563EB?style=flat-square" alt="Thai" />
<img src="https://img.shields.io/badge/🇻🇳_Tiếng_Việt-Supported-2563EB?style=flat-square" alt="Vietnamese" />
<img src="https://img.shields.io/badge/🇸🇦_العربية-Supported-2563EB?style=flat-square" alt="Arabic" />
</p>
所有 UI 元素、错误信息和文档均已完全翻译。语言会根据浏览器设置自动检测,也可以在应用中手动切换。
---
### 支持的市场
| 市场类型 | 数据源 | 交易 |
|-------------|--------------|---------|
| **加密货币** | Binance, OKX, Bitget, + 100 交易所 | ✅ 全面支持 |
| **美股** | Yahoo Finance, Finnhub, Tiingo | ✅ 通过券商 API |
| **A股/港股** | AkShare, 东方财富 | ⚡ 仅数据 |
| **外汇** | Finnhub, OANDA | ✅ 通过券商 API |
| **期货** | 交易所 API, AkShare | ⚡ 仅数据 |
---
### 架构 (当前仓库)
```text
┌─────────────────────────────┐
│ quantdinger_vue │
│ (Vue 2 + Ant Design Vue) │
└──────────────┬──────────────┘
│ HTTP (/api/*)
┌─────────────────────────────┐
│ backend_api_python │
│ (Flask + 策略运行时) │
└──────────────┬──────────────┘
├─ SQLite (quantdinger.db)
├─ Redis (可选缓存)
└─ 数据提供商 / LLMs / 交易所
```
---
### 仓库目录结构
```text
.
├─ backend_api_python/ # Flask API + AI + 回测 + 策略运行时
│ ├─ app/
│ ├─ env.example # 复制为 .env 进行本地配置
│ ├─ requirements.txt
│ └─ run.py # 入口点
└─ quantdinger_vue/ # Vue 2 UI (开发服务器代理 /api -> 后端)
```
---
## 快速开始
### 选项 1: Docker 部署 (推荐)
运行 QuantDinger 最快的方式。
#### 1. 准备配置
Linux/macOS:
```bash
cp docker.env.example backend_api_python/.env
nano backend_api_python/.env
```
Windows PowerShell:
```powershell
Copy-Item docker.env.example backend_api_python/.env
notepad backend_api_python/.env
```
**必需设置:**
- `SECRET_KEY` - 应用密钥,使用随机字符串
- `ADMIN_USER` / `ADMIN_PASSWORD` - 登录凭据
- `OPENROUTER_API_KEY` - OpenRouter API 密钥 (AI 分析必需)
#### 2. 构建并启动
```bash
# 构建镜像并启动 (首次运行)
docker-compose up -d --build
# 后续启动 (无需重新构建)
docker-compose up -d
```
#### 3. 访问应用
- **前端 UI**: http://localhost
- **后端 API**: http://localhost:5000
#### Docker 命令参考
```bash
# 查看运行状态
docker-compose ps
# 查看日志
docker-compose logs -f
# 停止服务
docker-compose down
# 停止并删除卷 (警告:会删除数据库!)
docker-compose down -v
```
#### 数据持久化
以下数据挂载到主机,重启容器后依然保留:
```yaml
volumes:
- ./backend_api_python/quantdinger.db:/app/quantdinger.db # 数据库
- ./backend_api_python/logs:/app/logs # 日志
- ./backend_api_python/data:/app/data # 数据目录
- ./backend_api_python/.env:/app/.env # 配置文件
```
---
### 选项 2: 本地开发
**先决条件**
- 推荐 Python 3.10+
- 推荐 Node.js 16+
#### 1. 启动后端 (Flask API)
```bash
cd backend_api_python
pip install -r requirements.txt
cp env.example .env # Windows: copy env.example .env
python run.py
```
后端将在 `http://localhost:5000` 上可用。
#### 2. 启动前端 (Vue UI)
```bash
cd quantdinger_vue
npm install
npm run serve
```
前端开发服务器运行在 `http://localhost:8000` 并将 `/api/*` 代理到 `http://localhost:5000`
---
### 配置 (.env)
使用 `backend_api_python/env.example` 作为模板。常用设置包括:
- **认证**: `SECRET_KEY`, `ADMIN_USER`, `ADMIN_PASSWORD`
- **服务器**: `PYTHON_API_HOST`, `PYTHON_API_PORT`, `PYTHON_API_DEBUG`
- **AI / LLM**: `OPENROUTER_API_KEY`, `OPENROUTER_MODEL`
- **网络搜索**: `SEARCH_PROVIDER`, `SEARCH_GOOGLE_*`, `SEARCH_BING_API_KEY`
- **代理 (可选)**: `PROXY_PORT``PROXY_URL`
---
## 🤝 社区与支持
加入我们的全球社区进行策略分享和技术支持:
- **Telegram (官方)**: [t.me/worldinbroker](https://t.me/worldinbroker)
- **Discord**: [Join Server](https://discord.gg/cn6HVE2KC)
- **YouTube**: [@quantdinger](https://youtube.com/@quantdinger)
- **Email**: [brokermr810@gmail.com](mailto:brokermr810@gmail.com)
- **GitHub Issues**: [提交 Bug / 功能请求](https://github.com/brokermr810/QuantDinger/issues)
---
## ☕ 支持本项目
如果 QuantDinger 帮助你获利,请考虑给开发者买杯咖啡。你的支持让项目持续发展!
**ERC-20 / BEP-20 / Polygon / Arbitrum**
```
0x96fa4962181bea077f8c7240efe46afbe73641a7
```
<img src="https://img.shields.io/badge/USDT-Accepted-26A17B?style=flat-square&logo=tether" alt="USDT">
<img src="https://img.shields.io/badge/ETH-Accepted-3C3C3D?style=flat-square&logo=ethereum" alt="ETH">
---
### 商业服务
我们提供专业服务,助你充分利用 QuantDinger
| 服务 | 描述 |
|---------|-------------|
| **部署与设置** | 一对一协助服务器部署、配置和优化 |
| **定制策略开发** | 针对特定需求和市场定制交易策略 |
| **企业版升级** | 商业授权、优先支持和企业级高级功能 |
| **培训与咨询** | 为你的交易团队提供实战培训和战略咨询 |
**感兴趣?** 联系我们:
- 📧 Email: [brokermr810@gmail.com](mailto:brokermr810@gmail.com)
- 💬 Telegram: [@worldinbroker](https://t.me/worldinbroker)
---
### 致谢
QuantDinger 站在这些伟大的开源项目肩膀之上:Flask, Pandas, CCXT, Vue.js, Ant Design Vue, KlineCharts 等。
感谢所有维护者和贡献者! ❤️
+365
View File
@@ -0,0 +1,365 @@
<div align="center">
<a href="README.md">🇺🇸 English</a> |
<a href="README_CN.md">🇨🇳 简体中文</a> |
<a href="README_TW.md">🇹🇼 繁體中文</a> |
<a href="README_JA.md">🇯🇵 日本語</a> |
<a href="README_KO.md">🇰🇷 한국어</a>
</div>
<br/>
<div align="center">
<a href="https://github.com/brokermr810/QuantDinger">
<img src="https://ai.quantdinger.com/img/logo.e0f510a8.png" alt="QuantDinger Logo" width="160" height="160">
</a>
<h1 align="center">QuantDinger</h1>
<p align="center">
<strong>🤖 AIネイティブ · 🔒 プライバシー重視 · 🚀 オールインワン定量的ワークスペース</strong>
</p>
<p align="center">
<i>次世代のローカル・クオンツプラットフォーム:マルチマーケットデータ、AIリサーチ、視覚的バックテスト、自動取引。</i>
</p>
<p align="center">
<a href="https://www.quantdinger.com"><strong>ウェブサイト</strong></a> ·
<a href="https://ai.quantdinger.com"><strong>ライブデモ</strong></a> ·
<a href="https://github.com/brokermr810/QuantDinger/issues"><strong>バグ報告</strong></a> ·
<a href="https://github.com/brokermr810/QuantDinger/discussions"><strong>ディスカッション</strong></a>
</p>
<p align="center">
<a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square&logo=apache" alt="License"></a>
<img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python">
<img src="https://img.shields.io/badge/Vue.js-2.x-4FC08D?style=flat-square&logo=vue.js&logoColor=white" alt="Vue">
<img src="https://img.shields.io/badge/Docker-Ready-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker">
<img src="https://img.shields.io/github/stars/brokermr810/QuantDinger?style=flat-square&logo=github" alt="Stars">
</p>
<p align="center">
<a href="https://t.me/worldinbroker"><img src="https://img.shields.io/badge/Telegram-Join%20Chat-26A5E4?style=for-the-badge&logo=telegram" alt="Telegram"></a>
<a href="https://discord.gg/cn6HVE2KC"><img src="https://img.shields.io/badge/Discord-Join%20Server-5865F2?style=for-the-badge&logo=discord" alt="Discord"></a>
<a href="https://x.com/HenryCryption"><img src="https://img.shields.io/badge/X-Follow%20Us-000000?style=for-the-badge&logo=x" alt="X"></a>
</p>
</div>
---
## 📖 はじめに
**QuantDinger** は、トレーダー、研究者、そしてギークのために設計された **ローカルファースト(Local-First** の定量的取引ワークスペースです。
高価なSaaSプラットフォームとは異なり、QuantDingerは **データの所有権** をあなたに取り戻します。**LLMベースのマルチエージェント・リサーチチーム** を内蔵しており、ウェブから金融情報を自律的に収集し、ローカルの市場データと組み合わせ、プロフェッショナルな分析レポートを作成し、戦略開発、バックテスト、実取引のワークフローとシームレスに統合します。
### コアバリュー
- **🛡️ プライバシー第一**: すべての戦略、取引ログ、APIキーはローカルのSQLiteデータベースに保存されます。
- **🧠 AIによる強化**: 単なるコード補完ではなく、OpenRouter/LLMを搭載した本物のAIリサーチアナリストです。
- **⚡ マルチマーケット**: **暗号資産**、**米国株**、**中国/香港株**、**FX**、**先物** をネイティブサポート。
- **🔌 すぐに使える**: Dockerによるワンクリックデプロイ。複雑な環境設定は不要です。
---
## 📸 ビジュアルツアー
<div align="center">
<h3>📊 プロフェッショナル・クオンツダッシュボード</h3>
<p>市場の動向、資産、戦略ステータスをリアルタイムで監視。</p>
<img src="docs/screenshots/dashboard.png" alt="QuantDinger Dashboard" width="100%" style="border-radius: 10px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);">
</div>
<br/>
<table align="center" width="100%">
<tr>
<td width="50%" align="center" valign="top">
<h3>🤖 AI ディープリサーチ</h3>
<p>市場センチメントとテクニカル分析のためのマルチエージェント・コラボレーション。</p>
<img src="docs/screenshots/ai_analysis1.png" alt="AI Market Analysis" style="border-radius: 6px;">
</td>
<td width="50%" align="center" valign="top">
<h3>💬 スマートトレーディングアシスタント</h3>
<p>即座に市場の洞察を得るための自然言語インターフェース。</p>
<img src="docs/screenshots/trading_assistant.png" alt="Trading Assistant" style="border-radius: 6px;">
</td>
</tr>
<tr>
<td width="50%" align="center" valign="top">
<h3>📈 インタラクティブなインジケーター分析</h3>
<p>ドラッグ&ドロップ分析を備えた豊富なテクニカルインジケーターライブラリ。</p>
<img src="docs/screenshots/indicator_analysis.png" alt="Indicator Analysis" style="border-radius: 6px;">
</td>
<td width="50%" align="center" valign="top">
<h3>🐍 Python 戦略生成</h3>
<p>AI支援による戦略コーディングが可能な内蔵エディタ。</p>
<img src="docs/screenshots/indicator_creat_python_code.png" alt="Code Generation" style="border-radius: 6px;">
</td>
</tr>
</table>
---
## ✨ 主な機能
### 1. ユニバーサルデータエンジン
データAPIについて心配する必要はもうありません。QuantDingerは強力なデータソースファクトリーパターンを備えています:
- **暗号資産**: 取引のための **直接API接続**(10以上の取引所)と、市場データのための **CCXT**100以上のソース)の組み合わせ。
- **株式**: Yahoo Finance、Finnhub、Tiingo(米国)、AkShare(中国/香港)を統合。
- **先物/FX**: OANDAおよび主要な先物データソースをサポート。
- **プロキシサポート**: 制限されたネットワーク環境のための内蔵プロキシ設定。
### 2. AI マルチエージェントリサーチ
疲れを知らないアナリストチーム:
- **コーディネーターエージェント**: タスクを分解し、ワークフローを管理します。
- **リサーチエージェント**: マクロニュースのためにウェブ全体(Google/Bing)を検索します。
- **暗号資産/株式エージェント**: 特定の市場のテクニカル分析と資金フロー分析に特化しています。
- **レポート生成**: 構造化された日次/週次リサーチレポートを自動的に作成します。
### 3. 堅牢な戦略ランタイム
- **スレッドベースのエグゼキューター**: 戦略実行のための独立したスレッドプール管理。
- **自動復元**: システム再起動後に実行中の戦略を自動的に再開します。
- **指値注文ワーカー**: 信頼性の高いバックグラウンドキューが、正確なシグナル実行を保証し、スリッページを防ぎます。
### 4. 最新の技術スタック
- **バックエンド**: Python (Flask) + SQLite + Redis (オプション) — シンプル、強力、拡張可能。
- **フロントエンド**: Vue 2 + Ant Design Vue + KlineCharts/ECharts — レスポンシブでインタラクティブ。
- **デプロイ**: Docker Compose オーケストレーション。
---
## 🏦 対応取引所 & リベート
QuantDingerは、低遅延実行のために主要な暗号資産取引所への **直接接続** をサポートし、広範な市場データカバレッジのために **CCXT** を使用します。
> 💡 **限定特典**: 以下のパートナーリンクからアカウントを作成すると、**取引手数料の割引** や **限定ボーナス** を受け取ることができます。これは、追加費用なしでプロジェクトを支援することにつながります!
| 取引所 | 特徴 | サインアップボーナス |
|:--------:|:---------|:-------------:|
| <img src="https://img.shields.io/badge/Binance-F0B90B?style=for-the-badge&logo=binance&logoColor=white" height="35"/> | 🥇 **世界最大**<br/>現物, 先物, マージン | <a href="https://www.bjwebptyiou.com/join/14449926"><img src="https://img.shields.io/badge/💰_手数料_20%25_OFF-00C853?style=for-the-badge" height="35"/></a> |
| <img src="https://img.shields.io/badge/OKX-000000?style=for-the-badge&logo=okx&logoColor=white" height="35"/> | 🚀 **Web3 & デリバティブ**<br/>現物, 無期限, オプション | <a href="https://www.bmwweb.ac/referral/earn-together/refer2earn-usdc/claim?hl=zh-CN&ref=GRO_28502_9OSOJ"><img src="https://img.shields.io/badge/🎁_ミステリーボックス-00C853?style=for-the-badge" height="35"/></a> |
| <img src="https://img.shields.io/badge/Bitget-00C7B1?style=for-the-badge&logoColor=white" height="35"/> | 👥 **ソーシャルトレーディング**<br/>コピートレーディング, 先物 | <a href="https://www.bitget.rocks/zh-CN/referral/register?clacCode=91AWLH0U&from=%2Fzh-CN%2Fevents%2Freferral-all-program&source=events&utmSource=PremierInviter"><img src="https://img.shields.io/badge/🔥_ボーナス請求-00C853?style=for-the-badge" height="35"/></a> |
<br>
**その他サポート (Direct/CCXT):**
| <img src="https://img.shields.io/badge/Bybit-F7931A?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/Gate.io-17E6A1?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/Kraken-5741D9?style=for-the-badge&logo=kraken&logoColor=white"/> | <img src="https://img.shields.io/badge/KuCoin-24AE8F?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/HTX-1A73E8?style=for-the-badge&logoColor=white"/> |
|:---:|:---:|:---:|:---:|:---:|
---
### 多言語サポート
QuantDingerは、包括的な国際化対応により、世界中のユーザー向けに構築されています。
全てのUI要素、エラーメッセージ、ドキュメントは完全に翻訳されています。言語はブラウザの設定に基づいて自動検出されますが、アプリ内で手動で切り替えることも可能です。
---
### 対応市場
| 市場タイプ | データソース | 取引 |
|-------------|--------------|---------|
| **暗号資産** | Binance, OKX, Bitget, + 100 取引所 | ✅ 完全サポート |
| **米国株** | Yahoo Finance, Finnhub, Tiingo | ✅ ブローカーAPI経由 |
| **中国/香港株** | AkShare, East Money | ⚡ データのみ |
| **FX** | Finnhub, OANDA | ✅ ブローカーAPI経由 |
| **先物** | 取引所API, AkShare | ⚡ データのみ |
---
### アーキテクチャ (現在のリポジトリ)
```text
┌─────────────────────────────┐
│ quantdinger_vue │
│ (Vue 2 + Ant Design Vue) │
└──────────────┬──────────────┘
│ HTTP (/api/*)
┌─────────────────────────────┐
│ backend_api_python │
│ (Flask + 戦略ランタイム) │
└──────────────┬──────────────┘
├─ SQLite (quantdinger.db)
├─ Redis (オプション キャッシュ)
└─ データプロバイダー / LLMs / 取引所
```
---
### リポジトリ構造
```text
.
├─ backend_api_python/ # Flask API + AI + バックテスト + 戦略ランタイム
│ ├─ app/
│ ├─ env.example # ローカル設定用に .env にコピー
│ ├─ requirements.txt
│ └─ run.py # エントリーポイント
└─ quantdinger_vue/ # Vue 2 UI (開発サーバーは /api をバックエンドにプロキシ)
```
---
## クイックスタート
### オプション 1: Docker デプロイ (推奨)
QuantDingerを実行する最速の方法です。
#### 1. 設定の準備
Linux/macOS:
```bash
cp docker.env.example backend_api_python/.env
nano backend_api_python/.env
```
Windows PowerShell:
```powershell
Copy-Item docker.env.example backend_api_python/.env
notepad backend_api_python/.env
```
**必須設定:**
- `SECRET_KEY` - アプリケーションシークレット(ランダムな文字列を使用)
- `ADMIN_USER` / `ADMIN_PASSWORD` - ログイン認証情報
- `OPENROUTER_API_KEY` - OpenRouter APIキー(AI分析に必要)
#### 2. ビルドと起動
```bash
# イメージのビルドと起動(初回)
docker-compose up -d --build
# 2回目以降の起動(再ビルド不要)
docker-compose up -d
```
#### 3. アプリケーションへのアクセス
- **フロントエンド UI**: http://localhost
- **バックエンド API**: http://localhost:5000
#### Docker コマンドリファレンス
```bash
# 実行状態の表示
docker-compose ps
# ログの表示
docker-compose logs -f
# サービスの停止
docker-compose down
# 停止してボリュームを削除 (警告: データベースが削除されます!)
docker-compose down -v
```
#### データの永続化
以下のデータはホストにマウントされ、コンテナの再起動後も保持されます:
```yaml
volumes:
- ./backend_api_python/quantdinger.db:/app/quantdinger.db # データベース
- ./backend_api_python/logs:/app/logs # ログ
- ./backend_api_python/data:/app/data # データディレクトリ
- ./backend_api_python/.env:/app/.env # 設定ファイル
```
---
### オプション 2: ローカル開発
**前提条件**
- Python 3.10+ (推奨)
- Node.js 16+ (推奨)
#### 1. バックエンドの起動 (Flask API)
```bash
cd backend_api_python
pip install -r requirements.txt
cp env.example .env # Windows: copy env.example .env
python run.py
```
バックエンドは `http://localhost:5000` で利用可能になります。
#### 2. フロントエンドの起動 (Vue UI)
```bash
cd quantdinger_vue
npm install
npm run serve
```
フロントエンド開発サーバーは `http://localhost:8000` で実行され、`/api/*``http://localhost:5000` にプロキシします。
---
### 設定 (.env)
`backend_api_python/env.example` をテンプレートとして使用してください。一般的な設定:
- **認証**: `SECRET_KEY`, `ADMIN_USER`, `ADMIN_PASSWORD`
- **サーバー**: `PYTHON_API_HOST`, `PYTHON_API_PORT`, `PYTHON_API_DEBUG`
- **AI / LLM**: `OPENROUTER_API_KEY`, `OPENROUTER_MODEL`
- **ウェブ検索**: `SEARCH_PROVIDER`, `SEARCH_GOOGLE_*`, `SEARCH_BING_API_KEY`
- **プロキシ (オプション)**: `PROXY_PORT` または `PROXY_URL`
---
## 🤝 コミュニティとサポート
戦略の共有や技術サポートのために、グローバルコミュニティに参加しましょう:
- **Telegram (公式)**: [t.me/worldinbroker](https://t.me/worldinbroker)
- **Discord**: [サーバーに参加](https://discord.gg/cn6HVE2KC)
- **YouTube**: [@quantdinger](https://youtube.com/@quantdinger)
- **Email**: [brokermr810@gmail.com](mailto:brokermr810@gmail.com)
- **GitHub Issues**: [バグ報告 / 機能リクエスト](https://github.com/brokermr810/QuantDinger/issues)
---
## ☕ プロジェクトを支援する
もしQuantDingerがあなたの利益に貢献したなら、開発者にコーヒーを一杯奢ることを検討してください。あなたの支援がプロジェクトを存続させます!
**ERC-20 / BEP-20 / Polygon / Arbitrum**
```
0x96fa4962181bea077f8c7240efe46afbe73641a7
```
<img src="https://img.shields.io/badge/USDT-Accepted-26A17B?style=flat-square&logo=tether" alt="USDT">
<img src="https://img.shields.io/badge/ETH-Accepted-3C3C3D?style=flat-square&logo=ethereum" alt="ETH">
---
### 商用サービス
QuantDingerを最大限に活用するためのプロフェッショナルサービスを提供しています:
| サービス | 説明 |
|---------|-------------|
| **デプロイ & セットアップ** | サーバーのデプロイ、設定、最適化に関するマンツーマンのサポート |
| **カスタム戦略開発** | 特定のニーズや市場に合わせて設計された取引戦略の開発 |
| **エンタープライズアップグレード** | 商用ライセンス、優先サポート、ビジネス向けの高度な機能 |
| **トレーニング & コンサルティング** | 取引チーム向けの実践的なトレーニングセッションと戦略コンサルティング |
**ご興味がありますか?** 以下よりお問い合わせください:
- 📧 Email: [brokermr810@gmail.com](mailto:brokermr810@gmail.com)
- 💬 Telegram: [@worldinbroker](https://t.me/worldinbroker)
---
### 謝辞
QuantDingerは、Flask, Pandas, CCXT, Vue.js, Ant Design Vue, KlineChartsなどの素晴らしいオープンソースプロジェクトの上に成り立っています。
すべてのメンテナとコントリビューターに感謝します! ❤️
+378
View File
@@ -0,0 +1,378 @@
<div align="center">
<a href="README.md">🇺🇸 English</a> |
<a href="README_CN.md">🇨🇳 简体中文</a> |
<a href="README_TW.md">🇹🇼 繁體中文</a> |
<a href="README_JA.md">🇯🇵 日本語</a> |
<a href="README_KO.md">🇰🇷 한국어</a>
</div>
<br/>
<div align="center">
<a href="https://github.com/brokermr810/QuantDinger">
<img src="https://ai.quantdinger.com/img/logo.e0f510a8.png" alt="QuantDinger Logo" width="160" height="160">
</a>
<h1 align="center">QuantDinger</h1>
<p align="center">
<strong>🤖 AI 네이티브 · 🔒 프라이버시 우선 · 🚀 올인원 퀀트 워크스페이스</strong>
</p>
<p align="center">
<i>차세대 로컬 퀀트 플랫폼: 멀티 마켓 데이터, AI 리서치, 시각적 백테스팅 및 자동 거래.</i>
</p>
<p align="center">
<a href="https://www.quantdinger.com"><strong>웹사이트</strong></a> ·
<a href="https://ai.quantdinger.com"><strong>라이브 데모</strong></a> ·
<a href="https://github.com/brokermr810/QuantDinger/issues"><strong>버그 신고</strong></a> ·
<a href="https://github.com/brokermr810/QuantDinger/discussions"><strong>토론</strong></a>
</p>
<p align="center">
<a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square&logo=apache" alt="License"></a>
<img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python">
<img src="https://img.shields.io/badge/Vue.js-2.x-4FC08D?style=flat-square&logo=vue.js&logoColor=white" alt="Vue">
<img src="https://img.shields.io/badge/Docker-Ready-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker">
<img src="https://img.shields.io/github/stars/brokermr810/QuantDinger?style=flat-square&logo=github" alt="Stars">
</p>
<p align="center">
<a href="https://t.me/worldinbroker"><img src="https://img.shields.io/badge/Telegram-Join%20Chat-26A5E4?style=for-the-badge&logo=telegram" alt="Telegram"></a>
<a href="https://discord.gg/cn6HVE2KC"><img src="https://img.shields.io/badge/Discord-Join%20Server-5865F2?style=for-the-badge&logo=discord" alt="Discord"></a>
<a href="https://x.com/HenryCryption"><img src="https://img.shields.io/badge/X-Follow%20Us-000000?style=for-the-badge&logo=x" alt="X"></a>
</p>
</div>
---
## 📖 소개
**QuantDinger**는 트레이더, 연구원 및 괴짜들을 위해 설계된 **로컬 우선(Local-First)** 퀀트 거래 워크스페이스입니다.
비싼 SaaS 플랫폼과 달리, QuantDinger는 **데이터 소유권**을 귀하에게 돌려드립니다. **LLM 기반 멀티 에이전트 리서치 팀**이 내장되어 있어 웹에서 금융 정보를 자율적으로 수집하고, 로컬 시장 데이터와 결합하여 전문 분석 보고서를 생성하며, 전략 개발, 백테스팅 및 실거래 워크플로우와 원활하게 통합됩니다.
### 핵심 가치
- **🛡️ 프라이버시 우선**: 모든 전략, 거래 로그 및 API 키는 로컬 SQLite 데이터베이스에 저장됩니다.
- **🧠 AI 강화**: 단순한 코드 완성이 아닌, OpenRouter/LLM으로 구동되는 진정한 AI 리서치 애널리스트입니다.
- **⚡ 멀티 마켓**: **암호화폐**, **미국 주식**, **중국/홍콩 주식**, **외환** 및 **선물**을 기본 지원합니다.
- **🔌 즉시 사용 가능**: Docker를 통한 원클릭 배포. 복잡한 환경 설정이 필요 없습니다.
---
## 📸 비주얼 투어
<div align="center">
<h3>📊 전문 퀀트 대시보드</h3>
<p>시장 역학, 자산 및 전략 상태에 대한 실시간 모니터링.</p>
<img src="docs/screenshots/dashboard.png" alt="QuantDinger Dashboard" width="100%" style="border-radius: 10px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);">
</div>
<br/>
<table align="center" width="100%">
<tr>
<td width="50%" align="center" valign="top">
<h3>🤖 AI 딥 리서치</h3>
<p>시장 심리 및 기술적 분석을 위한 멀티 에이전트 협업.</p>
<img src="docs/screenshots/ai_analysis1.png" alt="AI Market Analysis" style="border-radius: 6px;">
</td>
<td width="50%" align="center" valign="top">
<h3>💬 스마트 트레이딩 어시스턴트</h3>
<p>즉각적인 시장 통찰력을 위한 자연어 인터페이스.</p>
<img src="docs/screenshots/trading_assistant.png" alt="Trading Assistant" style="border-radius: 6px;">
</td>
</tr>
<tr>
<td width="50%" align="center" valign="top">
<h3>📈 대화형 지표 분석</h3>
<p>드래그 앤 드롭 분석이 가능한 풍부한 기술적 지표 라이브러리.</p>
<img src="docs/screenshots/indicator_analysis.png" alt="Indicator Analysis" style="border-radius: 6px;">
</td>
<td width="50%" align="center" valign="top">
<h3>🐍 Python 전략 생성</h3>
<p>AI 지원 전략 코딩이 가능한 내장 에디터.</p>
<img src="docs/screenshots/indicator_creat_python_code.png" alt="Code Generation" style="border-radius: 6px;">
</td>
</tr>
</table>
---
## ✨ 주요 기능
### 1. 범용 데이터 엔진
더 이상 데이터 API에 대해 걱정하지 마세요. QuantDinger는 강력한 데이터 소스 팩토리 패턴을 갖추고 있습니다:
- **암호화폐**: 거래를 위한 **직접 API 연결**(10개 이상의 거래소)과 시장 데이터를 위한 **CCXT**(100개 이상의 소스) 결합.
- **주식**: Yahoo Finance, Finnhub, Tiingo(미국) 및 AkShare(중국/홍콩) 통합.
- **선물/외환**: OANDA 및 주요 선물 데이터 소스 지원.
- **프록시 지원**: 제한된 네트워크 환경을 위한 내장 프록시 구성.
### 2. AI 멀티 에이전트 리서치
지치지 않는 분석가 팀:
- **코디네이터 에이전트**: 작업을 분해하고 워크플로우를 관리합니다.
- **리서치 에이전트**: 거시 뉴스를 위해 전체 웹(Google/Bing)을 검색합니다.
- **암호화폐/주식 에이전트**: 특정 시장에 대한 기술적 분석 및 자금 흐름 분석을 전문으로 합니다.
- **보고서 생성**: 구조화된 일일/주간 리서치 보고서를 자동으로 생성합니다.
### 3. 강력한 전략 런타임
- **스레드 기반 실행기**: 전략 실행을 위한 독립적인 스레드 풀 관리.
- **자동 복구**: 시스템 재시작 후 실행 중인 전략을 자동으로 재개합니다.
- **지정가 주문 워커**: 안정적인 백그라운드 대기열은 정확한 신호 실행을 보장하고 슬리피지를 방지합니다.
### 4. 최신 기술 스택
- **백엔드**: Python (Flask) + SQLite + Redis (옵션) — 간단하고 강력하며 확장이 용이합니다.
- **프론트엔드**: Vue 2 + Ant Design Vue + KlineCharts/ECharts — 반응형이며 인터랙티브합니다.
- **배포**: Docker Compose 오케스트레이션.
---
## 🏦 지원되는 거래소 및 리베이트
QuantDinger는 저지연 실행을 위해 주요 암호화폐 거래소에 **직접 연결**을 지원하며, 광범위한 시장 데이터 커버리지를 위해 **CCXT**를 사용합니다.
> 💡 **독점 혜택**: 아래 파트너 링크를 통해 계정을 생성하면 **거래 수수료 할인** 및 **독점 보너스**를 받을 수 있습니다. 이는 추가 비용 없이 프로젝트를 지원하는 데 도움이 됩니다!
| 거래소 | 특징 | 가입 보너스 |
|:--------:|:---------|:-------------:|
| <img src="https://img.shields.io/badge/Binance-F0B90B?style=for-the-badge&logo=binance&logoColor=white" height="35"/> | 🥇 **세계 최대**<br/>현물, 선물, 마진 | <a href="https://www.bjwebptyiou.com/join/14449926"><img src="https://img.shields.io/badge/💰_수수료_20%25_절약-00C853?style=for-the-badge" height="35"/></a> |
| <img src="https://img.shields.io/badge/OKX-000000?style=for-the-badge&logo=okx&logoColor=white" height="35"/> | 🚀 **Web3 & 파생상품**<br/>현물, 무기한, 옵션 | <a href="https://www.bmwweb.ac/referral/earn-together/refer2earn-usdc/claim?hl=zh-CN&ref=GRO_28502_9OSOJ"><img src="https://img.shields.io/badge/🎁_미스터리_박스-00C853?style=for-the-badge" height="35"/></a> |
| <img src="https://img.shields.io/badge/Bitget-00C7B1?style=for-the-badge&logoColor=white" height="35"/> | 👥 **소셜 트레이딩**<br/>카피 트레이딩, 선물 | <a href="https://www.bitget.rocks/zh-CN/referral/register?clacCode=91AWLH0U&from=%2Fzh-CN%2Fevents%2Freferral-all-program&source=events&utmSource=PremierInviter"><img src="https://img.shields.io/badge/🔥_보너스_청구-00C853?style=for-the-badge" height="35"/></a> |
<br>
**또한 지원됨 (Direct/CCXT):**
| <img src="https://img.shields.io/badge/Bybit-F7931A?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/Gate.io-17E6A1?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/Kraken-5741D9?style=for-the-badge&logo=kraken&logoColor=white"/> | <img src="https://img.shields.io/badge/KuCoin-24AE8F?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/HTX-1A73E8?style=for-the-badge&logoColor=white"/> |
|:---:|:---:|:---:|:---:|:---:|
---
### 다국어 지원
QuantDinger는 포괄적인 국제화를 통해 글로벌 사용자를 위해 구축되었습니다:
<p>
<img src="https://img.shields.io/badge/🇺🇸_English-Supported-2563EB?style=flat-square" alt="English" />
<img src="https://img.shields.io/badge/🇨🇳_简体中文-Supported-2563EB?style=flat-square" alt="Simplified Chinese" />
<img src="https://img.shields.io/badge/🇹🇼_繁體中文-Supported-2563EB?style=flat-square" alt="Traditional Chinese" />
<img src="https://img.shields.io/badge/🇯🇵_日本語-Supported-2563EB?style=flat-square" alt="Japanese" />
<img src="https://img.shields.io/badge/🇰🇷_한국어-Supported-2563EB?style=flat-square" alt="Korean" />
<img src="https://img.shields.io/badge/🇩🇪_Deutsch-Supported-2563EB?style=flat-square" alt="German" />
<img src="https://img.shields.io/badge/🇫🇷_Français-Supported-2563EB?style=flat-square" alt="French" />
<img src="https://img.shields.io/badge/🇹🇭_ไทย-Supported-2563EB?style=flat-square" alt="Thai" />
<img src="https://img.shields.io/badge/🇻🇳_Tiếng_Việt-Supported-2563EB?style=flat-square" alt="Vietnamese" />
<img src="https://img.shields.io/badge/🇸🇦_العربية-Supported-2563EB?style=flat-square" alt="Arabic" />
</p>
모든 UI 요소, 오류 메시지 및 문서는 완벽하게 번역되어 있습니다. 언어는 브라우저 설정에 따라 자동으로 감지되거나 앱에서 수동으로 전환할 수 있습니다.
---
### 지원되는 시장
| 시장 유형 | 데이터 소스 | 거래 |
|-------------|--------------|---------|
| **암호화폐** | Binance, OKX, Bitget, + 100 거래소 | ✅ 완전 지원 |
| **미국 주식** | Yahoo Finance, Finnhub, Tiingo | ✅ 브로커 API 경유 |
| **중국/홍콩 주식** | AkShare, East Money | ⚡ 데이터만 |
| **외환** | Finnhub, OANDA | ✅ 브로커 API 경유 |
| **선물** | 거래소 API, AkShare | ⚡ 데이터만 |
---
### 아키텍처 (현재 레포지토리)
```text
┌─────────────────────────────┐
│ quantdinger_vue │
│ (Vue 2 + Ant Design Vue) │
└──────────────┬──────────────┘
│ HTTP (/api/*)
┌─────────────────────────────┐
│ backend_api_python │
│ (Flask + 전략 런타임) │
└──────────────┬──────────────┘
├─ SQLite (quantdinger.db)
├─ Redis (옵션 캐시)
└─ 데이터 제공자 / LLMs / 거래소
```
---
### 레포지토리 구조
```text
.
├─ backend_api_python/ # Flask API + AI + 백테스트 + 전략 런타임
│ ├─ app/
│ ├─ env.example # 로컬 구성을 위해 .env로 복사
│ ├─ requirements.txt
│ └─ run.py # 엔트리 포인트
└─ quantdinger_vue/ # Vue 2 UI (개발 서버는 /api를 백엔드로 프록시)
```
---
## 빠른 시작
### 옵션 1: Docker 배포 (권장)
QuantDinger를 실행하는 가장 빠른 방법입니다.
#### 1. 구성 준비
Linux/macOS:
```bash
cp docker.env.example backend_api_python/.env
nano backend_api_python/.env
```
Windows PowerShell:
```powershell
Copy-Item docker.env.example backend_api_python/.env
notepad backend_api_python/.env
```
**필수 설정:**
- `SECRET_KEY` - 애플리케이션 비밀 키, 임의의 문자열 사용
- `ADMIN_USER` / `ADMIN_PASSWORD` - 로그인 자격 증명
- `OPENROUTER_API_KEY` - OpenRouter API 키 (AI 분석에 필요)
#### 2. 빌드 및 시작
```bash
# 이미지 빌드 및 시작 (처음 실행 시)
docker-compose up -d --build
# 후속 시작 (재빌드 필요 없음)
docker-compose up -d
```
#### 3. 애플리케이션 액세스
- **프론트엔드 UI**: http://localhost
- **백엔드 API**: http://localhost:5000
#### Docker 명령 참조
```bash
# 실행 상태 보기
docker-compose ps
# 로그 보기
docker-compose logs -f
# 서비스 중지
docker-compose down
# 볼륨 중지 및 제거 (경고: 데이터베이스가 삭제됩니다!)
docker-compose down -v
```
#### 데이터 지속성
다음 데이터는 호스트에 마운트되며 컨테이너 재시작 후에도 유지됩니다:
```yaml
volumes:
- ./backend_api_python/quantdinger.db:/app/quantdinger.db # 데이터베이스
- ./backend_api_python/logs:/app/logs # 로그
- ./backend_api_python/data:/app/data # 데이터 디렉토리
- ./backend_api_python/.env:/app/.env # 구성 파일
```
---
### 옵션 2: 로컬 개발
**전제 조건**
- Python 3.10+ 권장
- Node.js 16+ 권장
#### 1. 백엔드 시작 (Flask API)
```bash
cd backend_api_python
pip install -r requirements.txt
cp env.example .env # Windows: copy env.example .env
python run.py
```
백엔드는 `http://localhost:5000`에서 사용할 수 있습니다.
#### 2. 프론트엔드 시작 (Vue UI)
```bash
cd quantdinger_vue
npm install
npm run serve
```
프론트엔드 개발 서버는 `http://localhost:8000`에서 실행되며 `/api/*``http://localhost:5000`으로 프록시합니다.
---
### 구성 (.env)
`backend_api_python/env.example`을 템플릿으로 사용하십시오. 일반적인 설정은 다음과 같습니다:
- **인증**: `SECRET_KEY`, `ADMIN_USER`, `ADMIN_PASSWORD`
- **서버**: `PYTHON_API_HOST`, `PYTHON_API_PORT`, `PYTHON_API_DEBUG`
- **AI / LLM**: `OPENROUTER_API_KEY`, `OPENROUTER_MODEL`
- **웹 검색**: `SEARCH_PROVIDER`, `SEARCH_GOOGLE_*`, `SEARCH_BING_API_KEY`
- **프록시 (옵션)**: `PROXY_PORT` 또는 `PROXY_URL`
---
## 🤝 커뮤니티 및 지원
전략 공유 및 기술 지원을 위해 글로벌 커뮤니티에 참여하십시오:
- **Telegram (공식)**: [t.me/worldinbroker](https://t.me/worldinbroker)
- **Discord**: [서버 참여](https://discord.gg/cn6HVE2KC)
- **YouTube**: [@quantdinger](https://youtube.com/@quantdinger)
- **Email**: [brokermr810@gmail.com](mailto:brokermr810@gmail.com)
- **GitHub Issues**: [버그 신고 / 기능 요청](https://github.com/brokermr810/QuantDinger/issues)
---
## ☕ 프로젝트 후원
QuantDinger가 수익을 내는 데 도움이 되었다면 개발자에게 커피 한 잔을 사주시는 것을 고려해 보십시오. 귀하의 후원은 프로젝트를 살아있게 합니다!
**ERC-20 / BEP-20 / Polygon / Arbitrum**
```
0x96fa4962181bea077f8c7240efe46afbe73641a7
```
<img src="https://img.shields.io/badge/USDT-Accepted-26A17B?style=flat-square&logo=tether" alt="USDT">
<img src="https://img.shields.io/badge/ETH-Accepted-3C3C3D?style=flat-square&logo=ethereum" alt="ETH">
---
### 상용 서비스
QuantDinger를 최대한 활용할 수 있도록 전문 서비스를 제공합니다:
| 서비스 | 설명 |
|---------|-------------|
| **배포 및 설정** | 서버 배포, 구성 및 최적화에 대한 일대일 지원 |
| **맞춤형 전략 개발** | 귀하의 특정 요구와 시장에 맞춘 거래 전략 설계 |
| **엔터프라이즈 업그레이드** | 상용 라이선스, 우선 지원 및 비즈니스를 위한 고급 기능 |
| **교육 및 컨설팅** | 거래 팀을 위한 실전 교육 세션 및 전략 컨설팅 |
**관심이 있으십니까?** 다음을 통해 문의하십시오:
- 📧 Email: [brokermr810@gmail.com](mailto:brokermr810@gmail.com)
- 💬 Telegram: [@worldinbroker](https://t.me/worldinbroker)
---
### 감사의 말
QuantDinger는 Flask, Pandas, CCXT, Vue.js, Ant Design Vue, KlineCharts 등과 같은 훌륭한 오픈 소스 프로젝트의 어깨 위에 서 있습니다.
모든 관리자와 기여자에게 감사드립니다! ❤️
+379
View File
@@ -0,0 +1,379 @@
<div align="center">
<a href="README.md">🇺🇸 English</a> |
<a href="README_CN.md">🇨🇳 简体中文</a> |
<a href="README_TW.md">🇹🇼 繁體中文</a> |
<a href="README_JA.md">🇯🇵 日本語</a> |
<a href="README_KO.md">🇰🇷 한국어</a>
</div>
<br/>
<div align="center">
<a href="https://github.com/brokermr810/QuantDinger">
<img src="https://ai.quantdinger.com/img/logo.e0f510a8.png" alt="QuantDinger Logo" width="160" height="160">
</a>
<h1 align="center">QuantDinger</h1>
<p align="center">
<strong>🤖 AI 原生 · 🔒 隱私優先 · 🚀 全能量化工作台</strong>
</p>
<p align="center">
<i>下一代本地量化平台:多市場數據、AI 投研、可視化回測與自動交易。</i>
</p>
<p align="center">
<a href="https://www.quantdinger.com"><strong>官網</strong></a> ·
<a href="https://ai.quantdinger.com"><strong>在線演示</strong></a> ·
<a href="https://github.com/brokermr810/QuantDinger/issues"><strong>報告 Bug</strong></a> ·
<a href="https://github.com/brokermr810/QuantDinger/discussions"><strong>討論區</strong></a>
</p>
<p align="center">
<a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square&logo=apache" alt="License"></a>
<img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python">
<img src="https://img.shields.io/badge/Vue.js-2.x-4FC08D?style=flat-square&logo=vue.js&logoColor=white" alt="Vue">
<img src="https://img.shields.io/badge/Docker-Ready-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker">
<img src="https://img.shields.io/github/stars/brokermr810/QuantDinger?style=flat-square&logo=github" alt="Stars">
</p>
<p align="center">
<a href="https://t.me/worldinbroker"><img src="https://img.shields.io/badge/Telegram-Join%20Chat-26A5E4?style=for-the-badge&logo=telegram" alt="Telegram"></a>
<a href="https://discord.gg/cn6HVE2KC"><img src="https://img.shields.io/badge/Discord-Join%20Server-5865F2?style=for-the-badge&logo=discord" alt="Discord"></a>
<a href="https://x.com/HenryCryption"><img src="https://img.shields.io/badge/X-Follow%20Us-000000?style=for-the-badge&logo=x" alt="X"></a>
</p>
</div>
---
## 📖 簡介
**QuantDinger** 是一個專為交易員、研究員和極客設計的**本地優先**(Local-First)量化交易工作台。
與昂貴的 SaaS 平台不同,QuantDinger 將**數據所有權**歸還給你。它內置了一個**基於 LLM 的多智能體投研團隊**,能夠自動從網絡收集金融情報,結合本地行情數據,生成專業的分析報告,並與你的策略開發、回測及實盤交易流程無縫集成。
### 核心價值
- **🛡️ 隱私優先**:所有策略、交易日誌和 API 密鑰都存儲在你的本地 SQLite 數據庫中。
- **🧠 AI 賦能**:不僅是代碼補全,更是真正的 AI 投研分析師(由 OpenRouter/LLM 驅動)。
- **⚡ 多市場支持**:原生支持 **加密貨幣**、**美股**、**A股/港股**、**外匯** 和 **期貨**
- **🔌 開箱即用**:通過 Docker 一鍵部署。無需復雜的環境配置。
---
## 📸 功能預覽
<div align="center">
<h3>📊 專業量化儀表盤</h3>
<p>實時監控市場動態、資產狀況和策略狀態。</p>
<img src="docs/screenshots/dashboard.png" alt="QuantDinger Dashboard" width="100%" style="border-radius: 10px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);">
</div>
<br/>
<table align="center" width="100%">
<tr>
<td width="50%" align="center" valign="top">
<h3>🤖 AI 深度投研</h3>
<p>多智能體協作進行市場情緒與技術分析。</p>
<img src="docs/screenshots/ai_analysis1.png" alt="AI Market Analysis" style="border-radius: 6px;">
</td>
<td width="50%" align="center" valign="top">
<h3>💬 智能交易助手</h3>
<p>通過自然語言接口獲取即時市場洞察。</p>
<img src="docs/screenshots/trading_assistant.png" alt="Trading Assistant" style="border-radius: 6px;">
</td>
</tr>
<tr>
<td width="50%" align="center" valign="top">
<h3>📈 交互式指標分析</h3>
<p>豐富的技術指標庫,支持拖拽式分析。</p>
<img src="docs/screenshots/indicator_analysis.png" alt="Indicator Analysis" style="border-radius: 6px;">
</td>
<td width="50%" align="center" valign="top">
<h3>🐍 Python 策略生成</h3>
<p>內置編輯器,支持 AI 輔助策略代碼編寫。</p>
<img src="docs/screenshots/indicator_creat_python_code.png" alt="Code Generation" style="border-radius: 6px;">
</td>
</tr>
</table>
---
## ✨ 關鍵特性
### 1. 通用數據引擎
無需再為數據 API 發愁。QuantDinger 採用了強大的數據源工廠模式:
- **加密貨幣**:**直連交易所 API** 進行交易(支持 10+ 交易所),結合 **CCXT** 獲取行情數據(支持 100+ 來源)。
- **股票**:集成 Yahoo Finance、Finnhub、Tiingo (美股) 和 AkShare (A股/港股)。
- **期貨/外匯**:支持 OANDA 及主要期貨數據源。
- **代理支持**:內置代理配置,適應受限網絡環境。
### 2. AI 多智能體投研
你不知疲倦的分析師團隊:
- **協調智能體**:拆解任務並管理工作流。
- **搜索智能體**:進行全網搜索(Google/Bing)獲取宏觀新聞。
- **加密/股票智能體**:專注於特定市場的技術和資金流向分析。
- **報告生成**:自動產出結構化的日報/週報。
### 3. 穩健的策略運行時
- **基於線程的執行器**:獨立的線程池管理策略執行。
- **自動恢復**:系統重啟後自動恢復運行中的策略。
- **掛單工作線程**:可靠的後台隊列確保信號精準執行,防止滑點。
### 4. 現代技術棧
- **後端**Python (Flask) + SQLite + Redis (可選) — 簡潔、強大、易擴展。
- **前端**Vue 2 + Ant Design Vue + KlineCharts/ECharts — 響應式且交互豐富。
- **部署**Docker Compose 編排。
---
## 🏦 支持的交易所與返傭
QuantDinger 支持**直連**主要加密貨幣交易所進行低延遲執行,同時利用 **CCXT** 覆蓋廣泛的行情數據。
> 💡 **獨家福利**:通過下方的合作夥伴鏈接註冊賬戶,可享受**交易手續費減免**和**獨家贈金**。這將在不增加你成本的情況下支持本項目!
| 交易所 | 特點 | 註冊福利 |
|:--------:|:---------|:-------------:|
| <img src="https://img.shields.io/badge/Binance-F0B90B?style=for-the-badge&logo=binance&logoColor=white" height="35"/> | 🥇 **全球最大**<br/>現貨, 合約, 槓桿 | <a href="https://www.bjwebptyiou.com/join/14449926"><img src="https://img.shields.io/badge/💰_節省_20%25_手續費-00C853?style=for-the-badge" height="35"/></a> |
| <img src="https://img.shields.io/badge/OKX-000000?style=for-the-badge&logo=okx&logoColor=white" height="35"/> | 🚀 **Web3 & 衍生品**<br/>現貨, 永續, 期權 | <a href="https://www.bmwweb.ac/referral/earn-together/refer2earn-usdc/claim?hl=zh-CN&ref=GRO_28502_9OSOJ"><img src="https://img.shields.io/badge/🎁_領取盲盒-00C853?style=for-the-badge" height="35"/></a> |
| <img src="https://img.shields.io/badge/Bitget-00C7B1?style=for-the-badge&logoColor=white" height="35"/> | 👥 **社交交易**<br/>跟單交易, 合約 | <a href="https://www.bitget.rocks/zh-CN/referral/register?clacCode=91AWLH0U&from=%2Fzh-CN%2Fevents%2Freferral-all-program&source=events&utmSource=PremierInviter"><img src="https://img.shields.io/badge/🔥_領取贈金-00C853?style=for-the-badge" height="35"/></a> |
<br>
**同時也支持 (直連/CCXT):**
| <img src="https://img.shields.io/badge/Bybit-F7931A?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/Gate.io-17E6A1?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/Kraken-5741D9?style=for-the-badge&logo=kraken&logoColor=white"/> | <img src="https://img.shields.io/badge/KuCoin-24AE8F?style=for-the-badge&logoColor=white"/> | <img src="https://img.shields.io/badge/HTX-1A73E8?style=for-the-badge&logoColor=white"/> |
|:---:|:---:|:---:|:---:|:---:|
---
### 多語言支持
QuantDinger 為全球用戶構建,提供全面的國際化支持:
<p>
<img src="https://img.shields.io/badge/🇺🇸_English-Supported-2563EB?style=flat-square" alt="English" />
<img src="https://img.shields.io/badge/🇨🇳_簡體中文-Supported-2563EB?style=flat-square" alt="Simplified Chinese" />
<img src="https://img.shields.io/badge/🇹🇼_繁體中文-Supported-2563EB?style=flat-square" alt="Traditional Chinese" />
<img src="https://img.shields.io/badge/🇯🇵_日本語-Supported-2563EB?style=flat-square" alt="Japanese" />
<img src="https://img.shields.io/badge/🇰🇷_한국어-Supported-2563EB?style=flat-square" alt="Korean" />
<img src="https://img.shields.io/badge/🇩🇪_Deutsch-Supported-2563EB?style=flat-square" alt="German" />
<img src="https://img.shields.io/badge/🇫🇷_Français-Supported-2563EB?style=flat-square" alt="French" />
<img src="https://img.shields.io/badge/🇹🇭_ไทย-Supported-2563EB?style=flat-square" alt="Thai" />
<img src="https://img.shields.io/badge/🇻🇳_Tiếng_Việt-Supported-2563EB?style=flat-square" alt="Vietnamese" />
<img src="https://img.shields.io/badge/🇸🇦_العربية-Supported-2563EB?style=flat-square" alt="Arabic" />
</p>
所有 UI 元素、錯誤信息和文檔均已完全翻譯。語言會根據瀏覽器設置自動檢測,也可以在應用中手動切換。
---
### 支持的市場
| 市場類型 | 數據源 | 交易 |
|-------------|--------------|---------|
| **加密貨幣** | Binance, OKX, Bitget, + 100 交易所 | ✅ 全面支持 |
| **美股** | Yahoo Finance, Finnhub, Tiingo | ✅ 通過券商 API |
| **A股/港股** | AkShare, 東方財富 | ⚡ 僅數據 |
| **外匯** | Finnhub, OANDA | ✅ 通過券商 API |
| **期貨** | 交易所 API, AkShare | ⚡ 僅數據 |
---
### 架構 (當前倉庫)
```text
┌─────────────────────────────┐
│ quantdinger_vue │
│ (Vue 2 + Ant Design Vue) │
└──────────────┬──────────────┘
│ HTTP (/api/*)
┌─────────────────────────────┐
│ backend_api_python │
│ (Flask + 策略運行時) │
└──────────────┬──────────────┘
├─ SQLite (quantdinger.db)
├─ Redis (可選緩存)
└─ 數據提供商 / LLMs / 交易所
```
---
### 倉庫目錄結構
```text
.
├─ backend_api_python/ # Flask API + AI + 回測 + 策略運行時
│ ├─ app/
│ ├─ env.example # 複製為 .env 進行本地配置
│ ├─ requirements.txt
│ └─ run.py # 入口點
└─ quantdinger_vue/ # Vue 2 UI (開發服務器代理 /api -> 後端)
```
---
## 快速開始
### 選項 1: Docker 部署 (推薦)
運行 QuantDinger 最快的方式。
#### 1. 準備配置
Linux/macOS:
```bash
cp docker.env.example backend_api_python/.env
nano backend_api_python/.env
```
Windows PowerShell:
```powershell
Copy-Item docker.env.example backend_api_python/.env
notepad backend_api_python/.env
```
**必需設置:**
- `SECRET_KEY` - 應用密鑰,使用隨機字符串
- `ADMIN_USER` / `ADMIN_PASSWORD` - 登錄憑據
- `OPENROUTER_API_KEY` - OpenRouter API 密鑰 (AI 分析必需)
#### 2. 構建並啟動
```bash
# 構建鏡像並啟動 (首次運行)
docker-compose up -d --build
# 後續啟動 (無需重新構建)
docker-compose up -d
```
#### 3. 訪問應用
- **前端 UI**: http://localhost
- **後端 API**: http://localhost:5000
#### Docker 命令參考
```bash
# 查看運行狀態
docker-compose ps
# 查看日誌
docker-compose logs -f
# 停止服務
docker-compose down
# 停止並刪除卷 (警告:會刪除數據庫!)
docker-compose down -v
```
#### 數據持久化
以下數據掛載到主機,重啟容器後依然保留:
```yaml
volumes:
- ./backend_api_python/quantdinger.db:/app/quantdinger.db # 數據庫
- ./backend_api_python/logs:/app/logs # 日誌
- ./backend_api_python/data:/app/data # 數據目錄
- ./backend_api_python/.env:/app/.env # 配置文件
```
---
### 選項 2: 本地開發
**先決條件**
- 推薦 Python 3.10+
- 推薦 Node.js 16+
#### 1. 啟動後端 (Flask API)
```bash
cd backend_api_python
pip install -r requirements.txt
cp env.example .env # Windows: copy env.example .env
python run.py
```
後端將在 `http://localhost:5000` 上可用。
#### 2. 啟動前端 (Vue UI)
```bash
cd quantdinger_vue
npm install
npm run serve
```
前端開發服務器運行在 `http://localhost:8000` 並將 `/api/*` 代理到 `http://localhost:5000`
---
### 配置 (.env)
使用 `backend_api_python/env.example` 作為模板。常用設置包括:
- **認證**: `SECRET_KEY`, `ADMIN_USER`, `ADMIN_PASSWORD`
- **服務器**: `PYTHON_API_HOST`, `PYTHON_API_PORT`, `PYTHON_API_DEBUG`
- **AI / LLM**: `OPENROUTER_API_KEY`, `OPENROUTER_MODEL`
- **網絡搜索**: `SEARCH_PROVIDER`, `SEARCH_GOOGLE_*`, `SEARCH_BING_API_KEY`
- **代理 (可選)**: `PROXY_PORT``PROXY_URL`
---
## 🤝 社區與支持
加入我們的全球社區進行策略分享和技術支持:
- **Telegram (官方)**: [t.me/worldinbroker](https://t.me/worldinbroker)
- **Discord**: [Join Server](https://discord.gg/cn6HVE2KC)
- **YouTube**: [@quantdinger](https://youtube.com/@quantdinger)
- **Email**: [brokermr810@gmail.com](mailto:brokermr810@gmail.com)
- **GitHub Issues**: [提交 Bug / 功能請求](https://github.com/brokermr810/QuantDinger/issues)
---
## ☕ 支持本項目
如果 QuantDinger 幫助你獲利,請考慮給開發者買杯咖啡。你的支持讓項目持續發展!
**ERC-20 / BEP-20 / Polygon / Arbitrum**
```
0x96fa4962181bea077f8c7240efe46afbe73641a7
```
<img src="https://img.shields.io/badge/USDT-Accepted-26A17B?style=flat-square&logo=tether" alt="USDT">
<img src="https://img.shields.io/badge/ETH-Accepted-3C3C3D?style=flat-square&logo=ethereum" alt="ETH">
---
### 商業服務
我們提供專業服務,助你充分利用 QuantDinger
| 服務 | 描述 |
|---------|-------------|
| **部署與設置** | 一對一協助服務器部署、配置和優化 |
| **定制策略開發** | 針對特定需求和市場定制交易策略 |
| **企業版升級** | 商業授權、優先支持和企業級高級功能 |
| **培訓與咨詢** | 為你的交易團隊提供實戰培訓和戰略咨詢 |
**感興趣?** 聯繫我們:
- 📧 Email: [brokermr810@gmail.com](mailto:brokermr810@gmail.com)
- 💬 Telegram: [@worldinbroker](https://t.me/worldinbroker)
---
### 致謝
QuantDinger 站在這些偉大的開源項目肩膀之上:Flask, Pandas, CCXT, Vue.js, Ant Design Vue, KlineCharts 等。
感謝所有維護者和貢獻者! ❤️