Skip to content

QUICK_START.md

Latest commit

 

History

History
131 lines (94 loc) · 2.34 KB

QUICK_START.md

File metadata and controls

131 lines (94 loc) · 2.34 KB

🚀 投资推荐Agent快速开始指南

📋 前置要求

  • Python 3.8+
  • Docker (可选，用于容器化部署)
  • Tushare Pro账号
  • DeepSeek API账号

⚡ 快速设置

1. 安装依赖

pip install -r requirements.txt

2. 配置API密钥

方式一：使用配置脚本（推荐）

python setup_env.py

按照提示输入你的API密钥即可。

方式二：手动配置

  1. 复制环境变量模板：
cp env_template.txt .env
  1. 编辑 .env 文件，填入你的API密钥：
TUSHARE_TOKEN=your_actual_tushare_token
DEEPSEEK_API_KEY=your_actual_deepseek_key

3. 验证配置

python check_config.py

🎯 使用方法

基础使用

# 运行投资推荐Agent
python investment_agent_enhanced.py

# 运行Web API
python web_api.py

# 运行示例程序
python example_usage.py

Docker使用

# 启动Web API模式
./docker-start.sh web

# 启动基础模式
./docker-start.sh basic

# 查看帮助
./docker-start.sh help

📊 获取API密钥

Tushare Pro

  1. 访问 https://tushare.pro/
  2. 注册账号并登录
  3. 在个人中心获取token

DeepSeek

  1. 访问 https://platform.deepseek.com/
  2. 注册账号并登录
  3. 在API管理页面获取API key

🔧 常见问题

1. 环境变量未设置

❌ 错误: 请设置TUSHARE_TOKEN环境变量

解决方案: 运行 python setup_env.py 或手动创建 .env 文件

2. API连接失败

❌ Tushare API连接失败: Invalid token

解决方案: 检查API密钥是否正确，确保网络连接正常

3. 依赖包缺失

❌ 缺少依赖包: langgraph, langchain_openai

解决方案: 运行 pip install -r requirements.txt

4. Docker启动失败

❌ Docker未安装

解决方案: 安装Docker和Docker Compose

📖 详细文档

🆘 获取帮助

  1. 运行配置检查: python check_config.py
  2. 查看日志输出
  3. 检查网络连接
  4. 验证API密钥有效性

📞 支持

如果遇到问题，请：

  1. 运行 python check_config.py 检查配置
  2. 查看相关文档
  3. 检查API服务状态