worldquant-miner-cn

# WorldQuant Alpha 挖掘器

AI 驱动的 Alpha 因子生成、测试和提交系统。

## 功能

- ⛏️ **Alpha 生成** - Ollama 本地 LLM（3-5x 更快）
- 🧪 **自动测试** - WorldQuant Brain 平台模拟
- 📤 **智能提交** - 每日限制，自动过滤
- 🖥️ **Web Dashboard** - 实时监控和控制
- 🐳 **Docker 部署** - GPU 加速支持

## 架构

```
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Web Dashboard  │────▶│ Alpha Generator │────▶│ WorldQuant API  │
│    (Flask)      │     │    (Ollama)     │     │   (External)    │
│   Port 5000     │     │   Port 11434    │     │                 │
└─────────────────┘     └─────────────────┘     └─────────────────┘
         │                       │                       │
         └───────────────────────┼───────────────────────┘
                                 ▼
                     ┌─────────────────┐
                     │    Results &    │
                     │   Logs Storage  │
                     └─────────────────┘
```

## 快速开始

### 1. 配置凭据

```bash
# 创建凭据文件
echo '["your.email@worldquant.com", "your_password"]' > credential.txt
```

### 2. 启动系统

```bash
# GPU 版本（推荐）
docker-compose -f docker-compose.gpu.yml up -d

# CPU 版本
docker-compose up -d
```

### 3. 访问 Dashboard

- 主界面：http://localhost:5000
- Ollama WebUI：http://localhost:3000

## 使用方法

### Alpha 生成

```python
from worldquant_miner import AlphaGenerator

# 初始化
generator = AlphaGenerator(
    model="llama3.2:3b",
    credential_path="credential.txt"
)

# 生成 Alpha
alpha = generator.generate()
print(alpha)
# 输出：
# rank(ts_corr(close, volume, 20)) * -1
```

### Alpha 挖掘

```python
from worldquant_miner import AlphaMiner

# 从现有表达式挖掘变体
miner = AlphaMiner(
    expression="rank(ts_corr(close, volume, 20))",
    params={"window": [10, 20, 30, 60]}
)

# 运行
results = miner.run()
# 测试 4 个变体
```

### 批量提交

```python
from worldquant_miner import AlphaSubmitter

submitter = AlphaSubmitter(credential_path="credential.txt")...

# WorldQuant Miner CN

WorldQuant Alpha 挖掘器 - AI 驱动的 Alpha 因子生成系统。

## 功能

- ⛏️ Ollama 本地 LLM（3-5x 更快）
- 🧪 自动测试和提交
- 🖥️ Web Dashboard
- 🐳 Docker 部署

## 使用

```bash
# 配置凭据
echo '["email", "password"]' > credential.txt

# 启动
docker-compose -f docker-compose.gpu.yml up -d
```

## 来源

翻译自 [worldquant-miner](https://github.com/zhutoutoutousan/worldquant-miner)

## 许可证

Apache 2.0