217 lines
5.0 KiB
Markdown
217 lines
5.0 KiB
Markdown
# CryptoAI - 加密货币AI分析项目
|
||
|
||
基于Python的加密货币AI分析的AIAgent项目，利用人工智能对加密货币市场进行分析和预测。
|
||
|
||
## 功能特点
|
||
|
||
- 使用Binance API获取实时加密货币数据
|
||
- 利用DeepSeek大模型进行市场分析和预测
|
||
- 提供市场趋势、价格预测和交易建议
|
||
- 支持多种加密货币分析
|
||
- 通过钉钉机器人和Discord Webhook发送分析结果
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
cryptoai/
|
||
├── api/ # 与Binance API交互的模块
|
||
├── agents/ # AI智能体定义和实现
|
||
├── models/ # 模型定义和训练
|
||
├── utils/ # 工具函数
|
||
├── data/ # 数据存储
|
||
├── config/ # 配置文件
|
||
└── main.py # 主程序入口
|
||
```
|
||
|
||
## 安装与设置
|
||
|
||
### 本地部署
|
||
|
||
1. 克隆项目仓库
|
||
2. 安装依赖：`pip install -r requirements.txt`
|
||
3. 在`cryptoai/config/config.yaml`中配置Binance API密钥和DeepSeek API密钥
|
||
4. 运行`python run.py`启动应用
|
||
|
||
### Docker部署
|
||
|
||
1. 构建Docker镜像:
|
||
```bash
|
||
docker build -t cryptoai .
|
||
```
|
||
|
||
2. 运行容器:
|
||
```bash
|
||
docker run -d --name cryptoai \
|
||
-v $(pwd)/cryptoai/config/config.yaml:/app/cryptoai/config/config.yaml \
|
||
-v cryptoai_data:/app/cryptoai/data \
|
||
-v cryptoai_logs:/app/logs \
|
||
-e BINANCE_API_KEY=your_key \
|
||
-e BINANCE_API_SECRET=your_secret \
|
||
cryptoai
|
||
```
|
||
|
||
3. 使用Docker Compose部署:
|
||
```bash
|
||
# 创建.env文件（可以基于.env-example复制）
|
||
cp .env-example .env
|
||
# 编辑.env文件，填入API密钥和其他配置
|
||
vi .env
|
||
# 启动服务
|
||
docker-compose up -d
|
||
```
|
||
|
||
## 配置方式
|
||
|
||
项目支持两种配置方式：
|
||
|
||
### 1. 配置文件
|
||
|
||
在`cryptoai/config/config.yaml`中配置所有设置。示例可参考`cryptoai/config/config.example.yaml`。
|
||
|
||
### 2. 环境变量
|
||
|
||
通过环境变量覆盖配置文件中的设置，支持以下环境变量：
|
||
|
||
```
|
||
# 数据库配置
|
||
DB_HOST=数据库主机
|
||
DB_PORT=数据库端口
|
||
DB_USER=数据库用户名
|
||
DB_PASSWORD=数据库密码
|
||
DB_NAME=数据库名称
|
||
|
||
# Binance API
|
||
BINANCE_API_KEY=币安API密钥
|
||
BINANCE_API_SECRET=币安密钥
|
||
BINANCE_TEST_MODE=true/false
|
||
|
||
# DeepSeek API
|
||
DEEPSEEK_API_KEY=DeepSeek API密钥
|
||
DEEPSEEK_MODEL=使用的模型
|
||
|
||
# OKX API
|
||
OKX_API_KEY=OKX API密钥
|
||
OKX_API_SECRET=OKX密钥
|
||
OKX_PASSPHRASE=OKX密码
|
||
|
||
# 钉钉机器人
|
||
DINGTALK_ENABLED=true/false
|
||
DINGTALK_WEBHOOK_URL=钉钉Webhook地址
|
||
DINGTALK_SECRET=钉钉密钥
|
||
|
||
# Discord机器人
|
||
DISCORD_ENABLED=true/false
|
||
DISCORD_WEBHOOK_URL=Discord Webhook地址
|
||
```
|
||
|
||
在Docker中可以通过`-e`参数或`.env`文件传递环境变量。
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
# 运行一次分析
|
||
python run.py --run-once
|
||
|
||
# 分析特定加密货币
|
||
python run.py --symbol BTCUSDT
|
||
|
||
# 使用黄金分析智能体
|
||
python run.py --agent gold
|
||
|
||
# Docker中运行
|
||
docker run cryptoai --run-once --agent crypto
|
||
```
|
||
|
||
## 环境要求
|
||
|
||
- Python 3.9+
|
||
- MySQL 8.0+（使用远程MySQL数据库）
|
||
- 详细依赖见`requirements.txt`
|
||
|
||
## 数据库配置
|
||
|
||
项目使用SQLAlchemy ORM连接MySQL数据库，用于存储分析结果。默认连接到远程MySQL服务器，可以通过环境变量或配置文件自定义连接信息。
|
||
|
||
## API服务
|
||
|
||
项目现已集成FastAPI框架，提供了HTTP API接口，方便前端系统调用。
|
||
|
||
### 启动API服务
|
||
|
||
```bash
|
||
# 安装依赖
|
||
pip install -r requirements.txt
|
||
|
||
# 启动API服务
|
||
python run_api.py
|
||
```
|
||
|
||
API服务默认运行在 `http://0.0.0.0:8000`，可以通过环境变量自定义主机和端口：
|
||
|
||
```bash
|
||
API_HOST=127.0.0.1 API_PORT=8080 python run_api.py
|
||
```
|
||
|
||
### API文档
|
||
|
||
启动服务后，可以通过以下URL访问API文档：
|
||
|
||
- Swagger UI: `http://localhost:8000/docs`
|
||
- ReDoc: `http://localhost:8000/redoc`
|
||
|
||
### 主要API接口
|
||
|
||
- `GET /` - API信息
|
||
- `GET /health` - 健康检查
|
||
- `POST /api/analyze` - 分析加密货币市场趋势
|
||
- `GET /api/token-usage` - 获取DeepSeek API的token使用统计
|
||
- `POST /api/export-usage` - 导出token使用统计
|
||
|
||
### API调用示例
|
||
|
||
使用curl调用分析接口：
|
||
|
||
```bash
|
||
curl -X POST "http://localhost:8000/api/analyze" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"prompt": "分析比特币最近的市场趋势",
|
||
"symbol": "BTC",
|
||
"task_type": "市场分析"
|
||
}'
|
||
```
|
||
|
||
## 消息通知
|
||
|
||
项目支持多种消息通知方式，可以将分析结果发送到不同的平台。
|
||
|
||
### 钉钉机器人
|
||
|
||
在配置文件中设置钉钉机器人的Webhook URL和密钥，启用后会将分析结果发送到钉钉群聊。
|
||
|
||
```yaml
|
||
dingtalk:
|
||
enabled: true
|
||
webhook_url: your_dingtalk_webhook_url
|
||
secret: your_dingtalk_secret
|
||
```
|
||
|
||
### Discord机器人
|
||
|
||
在配置文件中设置Discord Webhook URL，启用后会将分析结果以精美的嵌入式消息发送到Discord频道。
|
||
|
||
```yaml
|
||
discord:
|
||
enabled: true
|
||
webhook_url: your_discord_webhook_url
|
||
username: CryptoAI分析机器人
|
||
avatar_url: https://cdn-icons-png.flaticon.com/512/2878/2878497.png
|
||
```
|
||
|
||
#### 测试Discord机器人
|
||
|
||
可以使用以下命令测试Discord机器人的功能：
|
||
|
||
```bash
|
||
python -m cryptoai.tests.test_discord_bot --webhook your_webhook_url
|
||
``` |