PanWatch

🧠 Start from a portfolio holding → let a nine-agent TradingAgents research team analyze it → follow the bull/bear debate and risk review → receive a PM decision memo and the complete reasoning trail in your messaging app within 3–5 minutes.

📸 Feature Overview

The screenshots below use the English interface; Simplified Chinese is available throughout the same product surfaces.

Portfolio · Multi-account overview	Opportunities · AI-scored ideas
Paper trading · Equity curve and performance	Deep stock analysis
Technical confluence · MACD/RSI/KDJ at a glance	Price alerts · Combined conditions

📱 PanWatch is an installable PWA and can be added to your mobile home screen like a native app.

💡 If PanWatch is useful to you, please consider giving the project a ⭐ Star. It is the best way to support the project and help more people discover it.

Core Features

Stock and listed ETF search, watchlists, holdings, price alerts, quotes and candlesticks share the same workflow across mainland China, Hong Kong and US markets. Search by code or name (for example, 510300, 159915, 02800 or SPY). The asset type is saved with each instrument; select ETF for funds whose provider name does not identify them as ETFs.

ETF deep analysis uses fund-specific context and does not substitute company financial statements. Fund holdings, NAV, fees and tracking error are not yet supplied as structured data. Paper trading continues to use its existing market rules and cost model; ETF-specific T+0 exceptions and fee schedules are not modeled.

Quick Start

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

Open http://localhost:8000 and create your login credentials.

Set TZ explicitly for background schedules and notification quiet hours, for example -e TZ=UTC or -e TZ=America/New_York. The image defaults to Asia/Shanghai and does not detect the host timezone. Interface timestamps and alert expiry inputs use the browser timezone. Timezone policy

1. Open the web interface and create your login credentials.
2. The main tour opens on first sign-in and follows stocks, quotes, AI setup and a first analysis. Required steps cannot be skipped; you can pause and resume. Reopen it from the Guide center, which also offers opportunities, paper trading, assistant, daily tasks and data sources, each with saved progress and replay. Click highlighted controls directly. The main tour verifies saved actions or successful checks; exploration routes record instructions you acknowledge.
3. In the main tour, configure a service in Settings → AI Services, set the default model, and test the connection before explicitly generating your first analysis. This action uses your model quota; its result stays on the page.
4. Optionally create a price alert and test a notification channel. You can defer or resume the guide; progress survives browser changes and service restarts. A changed model or channel configuration needs a new successful test.
5. Enable scheduled agents or explore TradingAgents after the basics work. These are configured separately from the first analysis.

services:
  panwatch:
    image: sunxiao0721/panwatch:latest
    container_name: panwatch
    environment:
      TZ: "Asia/Shanghai"
    ports:
      - "8000:8000"
    volumes:
      - panwatch_data:/app/data
    restart: unless-stopped

volumes:
  panwatch_data:

docker compose up -d

Change environment.TZ to your IANA timezone and run docker compose up -d to recreate the container. Review existing cron and quiet-hour wall times before changing it; the same 09:00 schedule will run at a different instant. Keep the data volume.

The image includes Playwright's system dependencies. Chromium's headless shell for screenshots is downloaded on first startup into the mounted volume (default /app/data/playwright), which requires network access and can take a few minutes.

If you do not need browser features such as screenshots, set PLAYWRIGHT_SKIP_BROWSER_INSTALL=1 to skip this installation.

Reference

Schedules are configurable. Automatic runs filter exchange holidays before collection and analysis; intraday workflows also require an open trading session.

Select the brain icon beside a holding to start TradingAgents deep analysis. Four analyst roles feed a bull/bear debate, risk review, and portfolio-manager decision, with the reasoning trail available in the app and through configured notification channels. Runtime and cost depend on the selected models and configuration.

Deep-analysis flowchart · Backend architecture

• Select the market status strip to compare all three exchanges across the next 14 dates. Opening/session times use your browser timezone; trade dates and status use each exchange's local date.
• A non-trading day shows closed; a completed trading day shows market closed. Beijing Saturday morning may still be New York Friday after close.
• Published 2026 closures and half-days are bundled locally. Startup warms only the previous 30 and next 90 days, without downloading full history. Unpublished weekdays show a pending calendar and block automatic execution; the bundled annual data must be updated for the next year.
• Agent Cron/interval settings remain unchanged; execution and schedule previews share calendar filters. Price alerts in “all d