项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2409
使用教程
环境要求
- 已安装 Docker(推荐 Docker 一键部署)
- 机器可访问外网:首次启动需自动下载 Chromium
- 浏览器(PC 或手机 PWA「添加到主屏幕」)
- 一个 OpenAI 兼容大模型 API Key(如 DeepSeek / OpenAI / 智谱 / Ollama)
- 本地开发环境需 Python 3.10+ / Node.js 18+ / pnpm
安装与启动步骤
-
1启动容器
在已装 Docker 的机器执行,映射 8000 端口并把数据存到 panwatch_data 卷;首次启动会自动下载 Chromium,耗时几分钟。
docker run -d --name panwatch -p 8000:8000 -v panwatch_data:/app/data sunxiao0721/panwatch:latest -
2改用 Compose
与 docker run 二选一。README 提供了 docker-compose.yml 模板,写好文件后在同一目录执行该命令即可后台启动。
docker-compose up -d -
3访问并设账号
浏览器打开 http://localhost:8000,首次使用设置登录账号密码;也可通过 AUTH_USERNAME、AUTH_PASSWORD 预设。
-
4配置 AI 服务商
进入「设置 → AI 服务商」,填 OpenAI 兼容 API,支持 OpenAI / 智谱 / DeepSeek / Ollama 等,默认 deepseek-chat。
-
5配置通知渠道
在「设置 → 通知渠道」添加 Telegram 或其他推送渠道,Agent 分析结论可推到 Telegram / 微信 / 钉钉。
-
6添加持仓股票
进入「持仓 → 添加股票」加入自选股并启用对应 Agent;点持仓页 图标可触发 TradingAgents 多 Agent 分析。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
AUTH_USERNAME | 否 | 预设登录用户名;不设则首次访问界面时设置 | admin |
AUTH_PASSWORD | 否 | 预设登录密码;不设则首次访问界面时设置 | your_password |
DATA_DIR | 否 | 数据存储目录,容器内默认 /app/data | ./data |
TZ | 否 | 应用时区,影响 Agent 调度触发时间与时间展示 | Asia/Shanghai |
PLAYWRIGHT_SKIP_BROWSER_INSTALL | 否 | 设为 1 可跳过首次 Chromium 下载安装,不需要截图能力时使用 | 1 |
LOG_LEVEL | 否 | 控制台日志级别,排查问题可设 DEBUG,UI 日志板不受影响 | INFO |
如何确认成功
浏览器能打开 http://localhost:8000,完成登录账号设置并看到持仓页面,即表示部署成功。
常见问题
Q:首次启动很慢,一直在下载?
A:容器首次启动会自动下载 Chromium 到挂载卷 /app/data/playwright,需网络可达,耐心等几分钟;不需要截图能力可加 PLAYWRIGHT_SKIP_BROWSER_INSTALL=1 跳过。
Q:支持哪些大模型?
A:任何 OpenAI 兼容 API 均可,README 点名支持 OpenAI / 智谱 / DeepSeek / Ollama 等,在「设置 → AI 服务商」里配置,默认使用 deepseek-chat。
Q:服务器出网需要走代理怎么办?
A:三种方式任选:启动前 export HTTP_PROXY=...;在 .env 写 http_proxy=http://host:port;或用 UI「设置 → 全局 HTTP 代理」。优先级为外部环境变量 > UI > .env。
Q:本地开发怎么跑起来?
A:环境要求 Python 3.10+ / Node.js 18+ / pnpm。OTel 相关需先 pip install -r requirements-otel.txt,然后 python server.py 启动。
注意事项
- 自托管部署,持仓数据不经过任何第三方,数据保存在挂载卷中,注意备份。
- TZ 会直接影响 Agent 调度触发时间和页面时间展示,请按所处市场时区设置。
- 配置 OTEL_EXPORTER_OTLP_ENDPOINT 才会导出 trace,留空则完全关闭且零副作用,还需安装 requirements-otel.txt。
- 出站代理配置生效后所有 httpx 客户端走代理,NO_PROXY 默认包含 localhost、127.0.0.1。
核心亮点
- 集成 TradingAgents 多 Agent 框架,提供更全面的投资决策分析。
- 支持 A股/港股/美股多市场实时监控,覆盖范围广。
- 自托管部署,数据私有化,且基于 FastAPI 轻量易扩展。
不足之处
- 早期项目,文档和社区支持待观察。
- 依赖外部 LLM API(如 OpenAI),可能产生费用和延迟。
适用场景
- 个人投资者盘中实时监控自选股,获取异动提醒。
- 持仓管理场景,自动汇总盈亏并生成分析报告。
- 需要私有化部署、数据不出内网的量化投研场景。
替代项目
TradingAgents、OpenBB、FinRobot
上一篇:bazi-ziwei-skill
下一篇:awesome-quant-ai
同类项目推荐
Daoyou
开源
AI 生成剧情,每局修仙路都不一样
《万界道友》是一款以 AIGC 驱动、高自由度文字体验、修仙世界观为核心的开源游戏。在这里···
Nola-Translator
开源
本地跑模型,说话即出多语字幕
Lightweight, powerful real-time speech translation with multilingual support and a m···
omniscient
开源
一个平台集成五种 AI 创作能力,开箱即用
Cutting-edge Full-stack AI Platform delivered as a SaaS (Software as a Service). Bui···
attackgen
开源
选威胁组织,一键生成定制化应急演练剧本
AttackGen is a cybersecurity incident response testing tool that leverages the power···
Beav
开源
一键安装,采集小红书素材,AI 自动写图文,提升创作效率。
小红书 AI 运营工作台|小红书采集、评论区下载、素材库、选题、AI写作、小红书全域解决方···
RSTGameTranslation
开源
截屏识别游戏文字,AI 实时翻译成中文字幕
Real-time Game Translation Tool | OCR + AI Translation | Windows Gaming | Open Sourc···
marketing-team-eve-template
开源
克隆即用的 AI 营销团队,自动写内容并分发
Team of marketing agents built on eve.
cardiobot
开源
专注心血管健康的智能问答助手,快速获取可靠医学知识
Cardio chatbot is trained on carefully curated datasets related to cardiovascular di···
ChatGPT-SDImg-Web
开源
把ChatGPT和SD绘图打包成可收费的网站,注册充值一步到位
基于ChatGPT-Next-Web,集成SD webui AI绘图,实现注册登录,次数限制,充值,分享等功能
