x-pai/AlphaBot

AlphaBot – 智能股票分析助手

它是什么 – AlphaBot 是一个开源应用程序，将大型语言模型（LLM）驱动的聊天助手与市场数据管道、可视化工具和简单的量化交易辅助功能整合在一起。它针对的是希望获得 AI 生成的分析，而不是仅依赖直觉的散户投资者。

主要功能

• AlphaBot Agent – 一个对话式金融机器人，可以回答问题、执行网络搜索以获取最新新闻，并根据自然语言提示生成图表或报告。
• 多来源市场数据 – 从 Alpha Vantage（全球市场）和 Tushare/AKShare（中国 A 股）获取实时报价。
• AI 增强分析 – 技术分析模式、基本面指标比较，以及一个预先训练的机器学习模型，用于预测价格走势。LLM（通过 OpenAI API）提供叙述性解释。
• 交易辅助工具 – 股票搜索、历史价格查看、常见技术指标、风险评估分数，以及量化策略建议。
• 网页界面 – React 前端（在 localhost:3000 提供服务），搭配 Swagger 文档化的 FastAPI 后端（localhost:8000/api/v1/docs）。

如何运行

1. Docker（推荐） – 克隆仓库，然后执行 ./deploy.sh（或在 Windows 上执行 ./deploy.ps1）。Docker-Compose 会构建后端、前端和数据库容器。服务会在上述 URL 上可达。
2. 手动安装 –
   • 后端：cd backend && pip install -r requirements.txt && uvicorn app.main:app --reload（可选择执行 python train_model.py 以重新训练 ML 预测器）。
   • 前端：cd frontend && npm install && npm run dev。
   • 默认管理员登录为 admin/admin123。

技术栈

• 后端 – Python、FastAPI、Uvicorn、SQLAlchemy（或类似）用于 API；使用 OpenAI API 进行 LLM 调用，并使用自定义 ML 模型进行价格预测。
• 前端 – React（JavaScript/TypeScript），UI 嵌入聊天代理和图表组件。
• 数据摄取 – Alpha Vantage、Tushare、AKShare API。
• 容器化 – Docker + Docker-Compose，用于一键部署。

目标受众 – 散户交易者和业余开发者，他们想要一个现成的 AI 驱动股票分析平台，可以自行托管和扩展。

注意事项 – README 强调了强烈的免责声明：该工具不保证获利，AI 可能犯错，数据质量取决于第三方提供商。请将其用于洞察，而非作为自动交易机器人。

社区与支持 – 该项目提供微信公众号、微信群组、QQ 群组和 Bilibili 教程视频。欢迎通过微信二维码赞助。

贡献 – 请参阅 CONTRIBUTING.md 了解分支政策、PR 模板和问题报告指南。