# alpha_arena

**Repository Path**: Zhipan200/alpha_arena

## Basic Information

- **Project Name**: alpha_arena
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-01
- **Last Updated**: 2026-01-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Alpha Arena - AI Trading Competition Platform

AI模型实盘交易竞赛平台，模拟Alpha Arena的核心功能。

## 功能特性

- ✅ **多模型独立账户**：每个AI模型拥有100万美金初始资金
- ✅ **实时市场数据**：通过Hyperliquid API获取加密货币实时价格
- ✅ **AI决策交易**：模型根据市场数据自主决策买入/卖出
- ✅ **实时Dashboard**：彭博终端风格的专业界面
- ✅ **净值曲线**：实时显示各模型账户净值变化
- ✅ **思考记录**：展示AI模型的决策思考过程
- ✅ **交易记录**：所有交易实时透明展示
- ✅ **Ollama Cloud集成**：支持多种大模型参与竞赛

## 项目结构

```
alpha_arena/
├── config/              # 配置文件
│   ├── config.py       # Python配置
│   └── config.yaml     # YAML配置
├── core/               # 核心模块
│   ├── account_manager.py    # 账户管理
│   ├── trading_engine.py     # 交易引擎
│   └── model_executor.py     # AI模型执行器
├── models/             # AI模型接口
│   └── ollama_model.py       # Ollama Cloud客户端
├── api/                # API接口
│   └── hyperliquid_client.py # Hyperliquid API客户端
├── web/                # Web应用
│   ├── app.py          # FastAPI应用
│   └── templates/      # HTML模板
├── utils/              # 工具函数
│   └── logger.py       # 日志
└── requirements.txt    # 依赖
```

## 安装步骤

### 1. 安装依赖

```bash
git clone https://gitee.com/extradimen/alpha_arena
cd alpha_arena
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```

### 2. 配置

编辑 `config/config.yaml` 或设置环境变量：

```bash
# Web服务端口（可修改）
export WEB_PORT=23003

# 初始资金（美元）
export INITIAL_CAPITAL=1000000

# Ollama Cloud API Key
export OLLAMA_API_KEY=your_api_key
```

### 3. 启动服务

**方式一：使用启动脚本（推荐）**

```bash
cd ~/alpha_arena
./start.sh
```

**方式二：手动启动**

```bash
cd ~/alpha_arena
source venv/bin/activate
python web/app.py
```

**方式三：使用uvicorn**

```bash
cd ~/alpha_arena
source venv/bin/activate
uvicorn web.app:app --host 0.0.0.0 --port 23003
```

**后台运行**

```bash
cd ~/alpha_arena
source venv/bin/activate
nohup python web/app.py > /dev/null 2>&1 &
```

### 4. 停止服务

使用停止脚本：

```bash
cd ~/alpha_arena
./stop.sh
```

脚本会自动查找并停止所有运行中的 Alpha Arena 进程。

### 5. 访问界面

打开浏览器访问：`http://localhost:23003`（或配置的端口）

## 使用方法

### 注册模型

1. 在Web界面的"模型管理"面板
2. 输入模型名称
3. 选择Ollama模型（DeepSeek V3.1、Qwen 2.5等）
4. 点击"注册模型"

### 查看实时数据

- **市场数据**：顶部显示6种加密货币实时价格
- **排行榜**：按总资产排序的模型排名
- **净值曲线**：实时更新的净值变化图表
- **思考记录**：AI模型的决策思考过程
- **交易记录**：所有买入/卖出交易

## 配置说明

### 端口配置

端口可通过以下方式配置：

1. **环境变量**：
```bash
export WEB_PORT=23003
```

2. **config.yaml**：
```yaml
web:
  port: 23003
```

3. **config.py**：
```python
WEB_PORT = 23003
```

### 交易配置

- `TRADING_INTERVAL`: 决策间隔（秒），默认60秒
- `MARKET_DATA_UPDATE_INTERVAL`: 市场数据更新间隔（秒），默认5秒
- `TRADING_SYMBOLS`: 支持的交易品种

## 技术栈

- **后端**: FastAPI + WebSocket
- **前端**: HTML + JavaScript + Chart.js
- **AI模型**: Ollama Cloud API
- **市场数据**: Hyperliquid API
- **样式**: 彭博终端风格（深色主题）

## 注意事项

1. 这是**虚拟盘**系统，使用模拟交易
2. 确保Ollama Cloud API Key有效
3. 网络连接正常以获取Hyperliquid市场数据
4. 建议在生产环境使用PostgreSQL替代SQLite

## 开发计划

- [ ] 添加更多技术指标
- [ ] 支持实盘交易（需要API Key）
- [ ] 添加风险控制模块
- [ ] 支持更多AI模型（OpenAI、Claude等）
- [ ] 数据持久化（数据库存储）

## License

仅供学习和研究使用。