sunxiao0721/panwatch repository overview

⁠PanWatch

A self-hosted AI stock monitoring and portfolio research workspace for China A-shares, Hong Kong, and U.S. markets. PanWatch combines watchlists, portfolio insights, technical signals, market news, price alerts, automated reports, and TradingAgents⁠ deep analysis while keeping your data on infrastructure you control.

English README⁠ · 简体中文介绍⁠ · Documentation⁠ · Releases⁠

⁠Highlights

• Monitor A-shares, Hong Kong stocks, and U.S. stocks in one self-hosted app.
• Track multiple portfolios, watchlists, P&L, and portfolio concentration risks.
• Schedule pre-market, intraday, and end-of-day AI research and deliver alerts through Telegram, WeCom, DingTalk, Feishu, Bark, or webhooks.
• Run TradingAgents multi-agent analysis with a visible execution trace, usage, and cost.
• Configure OpenAI-compatible providers, including local models through Ollama.
• Use the installable PWA on desktop and mobile. English and Simplified Chinese are supported.

⁠Quick start

docker run -d \
  --name panwatch \
  --restart unless-stopped \
  -p 8000:8000 \
  -v panwatch_data:/app/data \
  sunxiao0721/panwatch:latest

Open http://localhost:8000⁠, set up the login, then configure an AI provider under Settings → AI Services. Notification channels are optional. Add a holding or watchlist item to start exploring.

The official image supports linux/amd64 and linux/arm64. Keep /app/data on a named volume or host directory; it contains the database, configuration, and generated artifacts. Back up this volume before upgrading. Database migrations run automatically at startup.

For Docker Compose, environment variables, troubleshooting, and local development, see the Quick Start⁠ and documentation hub⁠.

⁠Screenshots

Portfolio	AI opportunities

⁠Security and privacy

PanWatch is designed for self-hosting. Portfolio records and provider credentials stay in your instance. Review SECURITY.md⁠ before reporting a security issue. AI-generated analysis is for research only and is not investment advice.

⁠Community

• Report a bug or request a feature⁠
• Contributing guide⁠
• Support the project⁠

Licensed under MIT⁠.