# nof1.ai-python

**Repository Path**: jiashaoying/nof1.ai-python

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-20
- **Last Updated**: 2025-11-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Open NOF1.ai - Python版

> AI驱动的加密货币自动交易系统 | Python实现

[![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/)
[![Status](https://img.shields.io/badge/status-production--ready-green.svg)]()

---

## 🌟 项目简介

**Open NOF1.ai** 是一个功能完整的AI驱动加密货币自动交易系统，从TypeScript完全迁移到Python实现。系统集成了先进的AI决策引擎、完善的风险管理机制和实时Web监控界面。

### 核心特性

- 🤖 **AI决策引擎** - 支持 DeepSeek、OpenAI 等多种AI模型，智能分析市场并做出交易决策
- 📊 **技术分析** - 支持EMA、MACD、RSI、ATR等多种技术指标
- 🔒 **风险管理** - 多层风控保护：止损、止盈、移动止盈、账户保护
- 💱 **交易所支持** - 基于ccxt库，支持200+交易所（主要针对Gate.io优化）
- 📈 **Web监控** - 实时监控界面，展示账户、持仓、交易和统计数据
- 🎯 **多策略** - 5种内置策略：保守、平衡、激进、超短线、波段趋势

---

## 📦 项目结构

```
python/
├── config/              # 配置模块
│   ├── settings.py     # 环境变量配置
│   └── risk_params.py  # 风险参数
├── core/               # 核心模块
│   ├── database.py     # 数据库连接
│   ├── logger.py       # 日志系统
│   └── models.py       # 数据模型
├── services/           # 业务服务
│   ├── exchange.py     # 交易所API
│   └── market_analysis.py  # 技术分析
├── agents/             # AI代理
│   └── trading_agent.py    # 交易策略
├── scheduler/          # 定时任务
│   ├── trading_loop.py     # 交易循环
│   ├── account_recorder.py # 账户记录
│   ├── stop_loss_monitor.py    # 止损监控
│   └── trailing_stop_monitor.py # 移动止盈
├── api/                # Web API
│   └── routes.py       # API路由
├── static/             # 静态文件
│   ├── index.html      # 监控界面
│   ├── css/            # 样式
│   └── js/             # 前端逻辑
├── tests/              # 测试文件
├── examples/           # 使用示例
├── utils/              # 工具函数
└── main.py             # 主程序
```

---

## 🚀 快速开始

### 1. 环境要求

- Python 3.9 或更高版本
- Gate.io账户（需要API密钥）
- DeepSeek AI密钥（推荐，成本仅为 OpenAI 的 1/10）

> 📖 [DeepSeek 配置指南](DEEPSEEK_SETUP.md) - 详细配置说明

### 2. 安装依赖

```bash
# 克隆项目
cd python

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# macOS/Linux:
source venv/bin/activate
# Windows:
# venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt
```

### 3. 配置环境变量

创建 `.env` 文件：

```bash
# Gate.io API
GATE_API_KEY=your_gate_api_key
GATE_API_SECRET=your_gate_api_secret
GATE_USE_TESTNET=true

# DeepSeek AI（推荐）
OPENAI_API_KEY=your_deepseek_api_key
OPENAI_BASE_URL=https://api.deepseek.com
OPENAI_MODEL=deepseek-chat

# 交易策略
TRADING_STRATEGY=balanced
```

> 📖 详细说明：[DeepSeek 配置](DEEPSEEK_SETUP.md) | [完整教程](QUICK_START.md)

### 4. 初始化数据库

```bash
python -c "from core.database import init_database; import asyncio; asyncio.run(init_database())"
```

### 5. 启动系统

```bash
# 启动完整系统（包含Web监控）
python main.py

# 系统启动后，访问监控界面：
# http://localhost:3100
```

---

## 🎯 使用指南

### 运行模式

#### 1. 完整模式（推荐）
```bash
python main.py
```
包含：自动交易、Web监控、账户记录、风控监控

#### 2. 仅Web API模式
```bash
# 在.env中设置：
ENABLE_AUTO_TRADING=false
ENABLE_WEB_API=true

python main.py
```

#### 3. 市场分析模式
```bash
# 运行示例脚本
python examples/trading_example.py
```

### Web监控界面

访问 http://localhost:3100 可以查看：

- 📊 **账户总览** - 总资产、可用余额、收益率
- 💼 **当前持仓** - 实时持仓信息和盈亏
- 📈 **交易统计** - 总交易次数、胜率、盈亏统计
- 📜 **交易历史** - 最近交易记录
- 💰 **实时价格** - 主流币种实时价格

### API文档

访问 http://localhost:3100/docs 查看完整的API文档（Swagger UI）

主要API端点：
- `GET /api/account` - 获取账户信息
- `GET /api/positions` - 获取当前持仓
- `GET /api/trades` - 获取交易记录
- `GET /api/stats` - 获取交易统计
- `GET /api/prices` - 获取实时价格

---

## ⚙️ 配置说明

### 交易策略

在`.env`文件中设置`TRADING_STRATEGY`：

| 策略 | 说明 | 适用场景 |
|-----|------|---------|
| `conservative` | 保守策略 | 风险厌恶，追求稳定收益 |
| `balanced` | 平衡策略 | 风险收益均衡 |
| `aggressive` | 激进策略 | 追求高收益，接受高风险 |
| `ultra-short` | 超短线策略 | 快进快出，持仓时间短 |
| `swing-trend` | 波段趋势策略 | 趋势跟踪，中长期持仓 |

### 风险参数

关键风险参数（在`.env`中配置）：

```bash
MAX_POSITIONS=5              # 最大持仓数量
MAX_LEVERAGE=10              # 最大杠杆倍数
TRADING_INTERVAL_MINUTES=5   # 交易循环间隔（分钟）
ACCOUNT_STOP_LOSS_USDT=50    # 账户止损线（USDT）
ACCOUNT_TAKE_PROFIT_USDT=200 # 账户止盈线（USDT）
```

---

## 📚 文档导航

### 🚀 新手必读（按顺序）
1. **README.md**（本文档）- 项目概览和功能介绍
2. **[快速开始](QUICK_START.md)** - 5分钟快速部署
3. **[DeepSeek 配置](DEEPSEEK_SETUP.md)** - AI 配置指南

### 📖 参考文档
- **[更新日志](CHANGELOG.md)** - 版本更新记录
- **示例代码** - `examples/` 目录
- **测试代码** - `tests/` 目录

---

## 🧪 测试

```bash
# 运行所有测试
./run_tests.sh

# 或使用 pytest
python -m pytest tests/ -v
```

**测试覆盖**：46个测试用例，100%通过率

---

## 🔐 安全提示

⚠️ **重要安全建议**：

1. **不要泄露API密钥** - 永远不要将`.env`文件提交到git
2. **先用测试网** - 建议先在Gate.io测试网测试
3. **小额测试** - 实盘前先用小额资金测试
4. **设置止损** - 务必配置账户级别的止损保护
5. **定期监控** - 定期检查系统运行状态和交易记录
6. **资金管理** - 不要投入超过承受能力的资金

---

## 📊 技术栈

- **Python** 3.9+ | **FastAPI** | **SQLAlchemy** | **ccxt**
- **AI**: DeepSeek / OpenAI（兼容多种模型）
- **分析**: pandas, pandas-ta, numpy
- **工具**: Loguru, Pydantic, tenacity

详见 [requirements.txt](requirements.txt)

---

## 📈 项目统计

- **代码**: 8000+ 行，46 个测试用例，100% 通过率
- **性能**: API < 100ms，决策 < 5s，内存 < 500MB
- **文档**: 4 个核心文档，精简易读

---

## 🤝 贡献

欢迎贡献代码、报告问题或提出改进建议！

1. Fork本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'feat: 添加某个很棒的功能'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启Pull Request

---

## 📝 许可证

本项目采用 **AGPL-3.0** 许可证 - 详见 [LICENSE](../LICENSE) 文件

---

## 🆘 获取帮助

### 常见问题

**Q: 如何获取 API 密钥？**
- **DeepSeek**（推荐）：访问 [platform.deepseek.com](https://platform.deepseek.com/)
- **Gate.io**：登录 Gate.io -> 个人中心 -> API管理

**Q: 为什么推荐 DeepSeek？**
A: 成本低廉（仅 OpenAI 的 1/10）、中文友好、性能优异。详见 [DeepSeek 配置](DEEPSEEK_SETUP.md)

**Q: 测试网和正式网如何切换？**
A: 在`.env`中设置`GATE_USE_TESTNET=true/false`

**Q: 如何禁用自动交易？**
A: 在`.env`中设置`ENABLE_AUTO_TRADING=false`

**Q: API调用失败怎么办？**
A: 检查API密钥是否正确，网络是否正常，查看日志文件`./logs/trading.log`

### 文档和支持

- 📖 快速开始：[QUICK_START.md](QUICK_START.md)
- 🤖 AI 配置：[DEEPSEEK_SETUP.md](DEEPSEEK_SETUP.md)
- 🐛 问题反馈：[GitHub Issues](https://github.com/195440/open-nof1.ai/issues)
- 💬 社区讨论：[GitHub Discussions](https://github.com/195440/open-nof1.ai/discussions)

---

## 🙏 致谢

感谢以下开源项目：

- [FastAPI](https://fastapi.tiangolo.com/) - 现代Web框架
- [ccxt](https://github.com/ccxt/ccxt) - 统一交易所API
- [pandas-ta](https://github.com/twopirllc/pandas-ta) - 技术分析库
- [SQLAlchemy](https://www.sqlalchemy.org/) - Python ORM
- [Loguru](https://github.com/Delgan/loguru) - 优雅的日志库

---

## 📞 联系方式

- **GitHub**: [195440/open-nof1.ai](https://github.com/195440/open-nof1.ai)
- **原TypeScript版本**: [open-nof1.ai](https://github.com/195440/open-nof1.ai)

---

<div align="center">

**🚀 祝您交易顺利！**

Made with ❤️ by Open NOF1.ai Team

</div>