TNT-Likely/PanWatchPublic

PanWatch — AI stock monitoring for A-shares, HK & US markets, powered by TradingAgents. Portfolio insights, real-time alerts & automated reports.|盯盘侠:覆盖 A股/港股/美股的 AI 盯盘、持仓分析、实时提醒与自动报告。

AI summary: Interactive CLI dashboard built with Blessed that monitors and visualizes stock market portfolios in real-time.

Stars
2.5K
+26 today
Forks
455
Watchers
22
Open issues
56
Open PRs
7
Contributors
~6
Commits
287
Branches
48

PythonMITCreated Jan 23, 2026Last push 3d agoLatest release 0.20.4+87 stars this week+393 this month

Quick answers

What is PanWatch?
Interactive CLI dashboard built with Blessed that monitors and visualizes stock market portfolios in real-time.
What does PanWatch do?
PanWatch is a self-hosted, AI-driven stock monitoring application designed for real-time surveillance of A-shares, Hong Kong, and US stock markets. It acts as a comprehensive dashboard that integrates multiple AI agents (via TradingAgents) to perform deep investment analysis. The system monitors live price action, technical indicators, and portfolio performance, sending real-time alerts across various channels. When triggered, the integrated 9-agent research team executes a complete reasoning chain—including bull/bear debates and risk control reviews—to generate actionable investment decisions. This automates complex quantitative and qualitative market research.
Who is PanWatch for?
PanWatch is for active retail investors, day traders, and tech-savvy individuals looking to automate market monitoring with AI. It requires basic knowledge of self-hosting and familiarity with stock market technical indicators.
How do I get started with PanWatch?
docker compose up -d
How popular is PanWatch on GitHub?
TNT-Likely/PanWatch has 2,531 stars and 455 forks on GitHub, and gained 87 stars in the last 7 days.
What license does PanWatch use?
TNT-Likely/PanWatch is released under the MIT license.

Star history

since Sep 23, 2026
01K2KSep 2026Oct 2026Oct 2026Nov 2026
2.5K stars as of Nov 18, 2026. Measured daily since Sep 23, 2026; GitHub no longer exposes earlier star timestamps.

Update history

4 recorded
  • Nov 14, 2026New release 0.20.4 (previously 0.20.2).
  • Oct 30, 2026New release 0.20.2 (previously 0.18.1).
  • Oct 19, 2026New release 0.18.1 (previously 0.17.4).
  • Oct 7, 2026New release 0.17.4 (previously 0.14.0).

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-16: 0 commits2025-11-17: 0 commits2025-11-18: 0 commits2025-11-19: 0 commits2025-11-20: 0 commits2025-11-21: 0 commits2025-11-22: 0 commits2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 0 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 0 commits2025-12-15: 0 commits2025-12-16: 0 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 0 commits2025-12-20: 0 commits2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 0 commits2026-01-07: 0 commits2026-01-08: 0 commits2026-01-09: 0 commits2026-01-10: 0 commits2026-01-11: 0 commits2026-01-12: 0 commits2026-01-13: 0 commits2026-01-14: 0 commits2026-01-15: 0 commits2026-01-16: 0 commits2026-01-17: 0 commits2026-01-18: 0 commits2026-01-19: 0 commits2026-01-20: 0 commits2026-01-21: 0 commits2026-01-22: 0 commits2026-01-23: 0 commits2026-01-24: 0 commits2026-01-25: 21 commits2026-01-26: 12 commits2026-01-27: 2 commits2026-01-28: 5 commits2026-01-29: 2 commits2026-01-30: 4 commits2026-01-31: 0 commits2026-02-01: 0 commits2026-02-02: 0 commits2026-02-03: 0 commits2026-02-04: 0 commits2026-02-05: 0 commits2026-02-06: 0 commits2026-02-07: 0 commits2026-02-08: 0 commits2026-02-09: 15 commits2026-02-10: 20 commits2026-02-11: 4 commits2026-02-12: 5 commits2026-02-13: 8 commits2026-02-14: 0 commits2026-02-15: 0 commits2026-02-16: 0 commits2026-02-17: 0 commits2026-02-18: 0 commits2026-02-19: 0 commits2026-02-20: 0 commits2026-02-21: 0 commits2026-02-22: 0 commits2026-02-23: 0 commits2026-02-24: 0 commits2026-02-25: 0 commits2026-02-26: 0 commits2026-02-27: 0 commits2026-02-28: 0 commits2026-03-01: 0 commits2026-03-02: 0 commits2026-03-03: 0 commits2026-03-04: 1 commit2026-03-05: 0 commits2026-03-06: 1 commit2026-03-07: 0 commits2026-03-08: 0 commits2026-03-09: 0 commits2026-03-10: 2 commits2026-03-11: 0 commits2026-03-12: 0 commits2026-03-13: 0 commits2026-03-14: 0 commits2026-03-15: 0 commits2026-03-16: 0 commits2026-03-17: 0 commits2026-03-18: 0 commits2026-03-19: 0 commits2026-03-20: 0 commits2026-03-21: 0 commits2026-03-22: 0 commits2026-03-23: 7 commits2026-03-24: 0 commits2026-03-25: 0 commits2026-03-26: 0 commits2026-03-27: 0 commits2026-03-28: 0 commits2026-03-29: 0 commits2026-03-30: 0 commits2026-03-31: 0 commits2026-04-01: 0 commits2026-04-02: 0 commits2026-04-03: 2 commits2026-04-04: 1 commit2026-04-05: 2 commits2026-04-06: 0 commits2026-04-07: 0 commits2026-04-08: 0 commits2026-04-09: 0 commits2026-04-10: 0 commits2026-04-11: 0 commits2026-04-12: 0 commits2026-04-13: 0 commits2026-04-14: 0 commits2026-04-15: 0 commits2026-04-16: 4 commits2026-04-17: 0 commits2026-04-18: 0 commits2026-04-19: 0 commits2026-04-20: 0 commits2026-04-21: 0 commits2026-04-22: 0 commits2026-04-23: 0 commits2026-04-24: 0 commits2026-04-25: 0 commits2026-04-26: 0 commits2026-04-27: 0 commits2026-04-28: 0 commits2026-04-29: 0 commits2026-04-30: 0 commits2026-05-01: 0 commits2026-05-02: 0 commits2026-05-03: 0 commits2026-05-04: 0 commits2026-05-05: 0 commits2026-05-06: 0 commits2026-05-07: 0 commits2026-05-08: 0 commits2026-05-09: 0 commits2026-05-10: 0 commits2026-05-11: 0 commits2026-05-12: 0 commits2026-05-13: 0 commits2026-05-14: 0 commits2026-05-15: 0 commits2026-05-16: 8 commits2026-05-17: 4 commits2026-05-18: 0 commits2026-05-19: 0 commits2026-05-20: 0 commits2026-05-21: 0 commits2026-05-22: 0 commits2026-05-23: 0 commits2026-05-24: 0 commits2026-05-25: 0 commits2026-05-26: 0 commits2026-05-27: 0 commits2026-05-28: 0 commits2026-05-29: 0 commits2026-05-30: 0 commits2026-05-31: 9 commits2026-06-01: 0 commits2026-06-02: 0 commits2026-06-03: 0 commits2026-06-04: 6 commits2026-06-05: 0 commits2026-06-06: 0 commits2026-06-07: 0 commits2026-06-08: 0 commits2026-06-09: 0 commits2026-06-10: 0 commits2026-06-11: 0 commits2026-06-12: 0 commits2026-06-13: 0 commits2026-06-14: 0 commits2026-06-15: 0 commits2026-06-16: 0 commits2026-06-17: 0 commits2026-06-18: 32 commits2026-06-19: 0 commits2026-06-20: 5 commits2026-06-21: 6 commits2026-06-22: 1 commit2026-06-23: 0 commits2026-06-24: 0 commits2026-06-25: 0 commits2026-06-26: 0 commits2026-06-27: 0 commits2026-06-28: 0 commits2026-06-29: 0 commits2026-06-30: 0 commits2026-07-01: 0 commits2026-07-02: 0 commits2026-07-03: 0 commits2026-07-04: 1 commit2026-07-05: 0 commits2026-07-06: 0 commits2026-07-07: 0 commits2026-07-08: 0 commits2026-07-09: 0 commits2026-07-10: 0 commits2026-07-11: 0 commits2026-07-12: 0 commits2026-07-13: 0 commits2026-07-14: 0 commits2026-07-15: 0 commits2026-07-16: 0 commits2026-07-17: 0 commits2026-07-18: 1 commit2026-07-19: 0 commits2026-07-20: 0 commits2026-07-21: 0 commits2026-07-22: 0 commits2026-07-23: 0 commits2026-07-24: 0 commits2026-07-25: 0 commits2026-07-26: 0 commits2026-07-27: 0 commits2026-07-28: 0 commits2026-07-29: 0 commits2026-07-30: 0 commits2026-07-31: 0 commits2026-08-01: 0 commits2026-08-02: 1 commit2026-08-03: 0 commits2026-08-04: 0 commits2026-08-05: 0 commits2026-08-06: 0 commits2026-08-07: 0 commits2026-08-08: 0 commits2026-08-09: 0 commits2026-08-10: 0 commits2026-08-11: 0 commits2026-08-12: 2 commits2026-08-13: 0 commits2026-08-14: 0 commits2026-08-15: 0 commits2026-08-16: 0 commits2026-08-17: 0 commits2026-08-18: 0 commits2026-08-19: 0 commits2026-08-20: 0 commits2026-08-21: 0 commits2026-08-22: 0 commits2026-08-23: 0 commits2026-08-24: 0 commits2026-08-25: 0 commits2026-08-26: 0 commits2026-08-27: 1 commit2026-08-28: 0 commits2026-08-29: 0 commits2026-08-30: 0 commits2026-08-31: 0 commits2026-09-01: 0 commits2026-09-02: 2 commits2026-09-03: 0 commits2026-09-04: 0 commits2026-09-05: 0 commits2026-09-06: 0 commits2026-09-07: 0 commits2026-09-08: 0 commits2026-09-09: 0 commits2026-09-10: 0 commits2026-09-11: 0 commits2026-09-12: 4 commits2026-09-13: 1 commit2026-09-14: 0 commits2026-09-15: 1 commit2026-09-16: 1 commit2026-09-17: 2 commits2026-09-18: 0 commits2026-09-19: 0 commits2026-09-20: 2 commits2026-09-21: 1 commit2026-09-22: 0 commits2026-09-23: 0 commits2026-09-24: 3 commits2026-09-25: 2 commits2026-09-26: 0 commits2026-09-27: 2 commits2026-09-28: 6 commits2026-09-29: 1 commit2026-09-30: 0 commits2026-10-01: 6 commits2026-10-02: 0 commits2026-10-03: 5 commits2026-10-04: 2 commits2026-10-05: 5 commits2026-10-06: 0 commits2026-10-07: 0 commits2026-10-08: 0 commits2026-10-09: 3 commits2026-10-10: 2 commits2026-10-11: 3 commits2026-10-12: 2 commits2026-10-13: 1 commit2026-10-14: 0 commits2026-10-15: 0 commits2026-10-16: 1 commit2026-10-17: 0 commits2026-10-18: 2 commits2026-10-19: 0 commits2026-10-20: 0 commits2026-10-21: 1 commit2026-10-22: 1 commit2026-10-23: 0 commits2026-10-24: 5 commits2026-10-25: 0 commits2026-10-26: 0 commits2026-10-27: 1 commit2026-10-28: 0 commits2026-10-29: 0 commits2026-10-30: 3 commits2026-10-31: 0 commits2026-11-01: 1 commit2026-11-02: 0 commits2026-11-03: 0 commits2026-11-04: 1 commit2026-11-05: 0 commits2026-11-06: 0 commits2026-11-07: 0 commits2026-11-08: 1 commit2026-11-09: 0 commits2026-11-10: 0 commits2026-11-11: 0 commits2026-11-12: 0 commits2026-11-13: 0 commits2026-11-14: 0 commits
269 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Well documented

    High community health score

  • Permissive license

    MIT

  • Continuous integration

    Automated checks passing

What PanWatch does

PanWatch is a self-hosted, AI-driven stock monitoring application designed for real-time surveillance of A-shares, Hong Kong, and US stock markets. It acts as a comprehensive dashboard that integrates multiple AI agents (via TradingAgents) to perform deep investment analysis. The system monitors live price action, technical indicators, and portfolio performance, sending real-time alerts across various channels. When triggered, the integrated 9-agent research team executes a complete reasoning chain—including bull/bear debates and risk control reviews—to generate actionable investment decisions. This automates complex quantitative and qualitative market research.

PanWatch is for active retail investors, day traders, and tech-savvy individuals looking to automate market monitoring with AI. It requires basic knowledge of self-hosting and familiarity with stock market technical indicators.

  • Multi-agent analysis: Integrates a 9-agent AI team to debate, review, and synthesize complex investment decisions.
  • Cross-market monitoring: Tracks real-time data across Chinese A-shares, Hong Kong stocks, and US equities.
  • Technical indicator resonance: Automatically detects and alerts on converging technical signals like MACD, RSI, and KDJ.
  • Portfolio management: Aggregates multiple accounts to track overall net worth curves and historical performance.
  • Omni-channel push: Delivers detailed AI reasoning chains and price alerts directly to instant messaging apps.

Where teams use it

Automate stock research

Click on a holding to trigger a full AI analysis pipeline that outputs a detailed, multi-perspective investment thesis.

Monitor technical signals

Set up complex price and indicator combinations to receive instant push notifications when market conditions are met.

Track global portfolios

Consolidate holdings across US, HK, and A-share markets into a single, real-time net worth dashboard.

Access market data on mobile

Install the PWA on a mobile device for native-app-like access to real-time market surveillance and AI alerts.

Getting started: docker compose up -d

README

main branch

PanWatch — Self-hosted AI stock monitoring

English | 简体中文 | 日本語

Monitor A-shares, Hong Kong, and U.S. stocks, manage your portfolios, and research ideas with TradingAgents. Self-host PanWatch with your preferred OpenAI-compatible provider or local models through Ollama.

Feature overview · Core features · Quick start · Reference · Support · Contributing

GitHub stars Docker Pulls License: MIT Last commit PWA

GitHub Trending Repository of the Day

PanWatch TradingAgents deep-analysis demo

🧠 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.

❤️ Sponsors
Logo Introduction
88API 88API Token Aggregation Platform

🧠 Access language and coding models including GPT, Claude, Gemini, Grok, DeepSeek, Kimi, and GLM;
🎨 Image models: GPT-Image, Gemini, Grok, and more;
🎬 Video models: Seedance, Veo, MiniMax H3, Kling, Grok, and more;
🎙️ Speech capabilities: Whisper, TTS, and more. From copywriting and image generation and editing to video generation and voiceovers.
🎁 New users receive trial credits upon registration to test model capabilities. Live customer support is available on the site!
👉 Operated by a registered Hong Kong company · Stable availability · Fully operational, full-capability service · No reduced model intelligence · Invoices available

Register now →

📸 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
Portfolio management AI-scored opportunities
Paper trading · Equity curve and performance Deep stock analysis
Paper trading Stock details
Technical confluence · MACD/RSI/KDJ at a glance Price alerts · Combined conditions
Technical indicators Price alerts
Mobile screenshots

📱 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

Capability What you can do
Portfolio Manage multiple brokerage accounts, track holdings and P&L, and set trading styles.
AI research Follow technical, sentiment, news, and fundamentals analysis through debate, risk review, and a portfolio-manager decision.
Scheduled agents Run pre-market, intraday, and closing workflows on eligible exchange trading days using your configured schedules.
Price alerts Combine conditions with AND/OR logic and configure cooldowns, daily limits, expiration, and notification channels.
Opportunities Review ranked candidates with entry levels, targets, and risk context.
Paper trading Simulate signal-based entries and exits, then track equity and performance.
Notifications Deliver reports and alerts through Telegram, WeCom, DingTalk, Feishu, Bark, or webhooks.
Mobile Install the PWA on your home screen and use the same workspace on your phone.

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

Initial setup
  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.
Docker Compose
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.

First startup and browser installation

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

Scheduled agents and deep analysis
Agent Purpose
Pre-market outlook Combine overnight moves, news, and technical structure into a plan.
Intraday monitor Watch unusual moves and technical signals during open sessions.
Daily report Review the session and prepare the next trading day's plan.

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

Market calendars and scheduling
  • 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 day” mode still require a trading day.
  • Paper fills require an open session for that stock's market. Paper notifications follow each exchange's local clock, including half-days and U.S. daylight-saving changes.
  • Mainland China paper positions follow T+1 using the Shanghai purchase date: automatic and manual sells are blocked on the purchase date and allowed from the next trading day, without waiting 24 hours. Prices and unrealized P&L continue updating while locked; stop-loss, take-profit and other exit conditions are checked again when selling becomes available, using the then-current quote.
  • Paper cash settlement is separate from sell eligibility: A shares settle T+1 and allow sale proceeds to fund new purchases immediately; HK (T+2) and US (T+1) use a cash account that only buys with settled, unreserved funds. The page shows cash balance, buying power, settled available cash and outstanding sale proceeds. Purchases reserve cash immediately; settlement changes availability without crediting cash or P&L again.
  • Settlement dates use each market's local calendar. HK half-days are non-settlement days; US Columbus Day and Veterans Day also defer settlement even when stocks trade. The simulation releases funds at the start of the due date, rather than modeling intraday clearing batches, withdrawal cutoffs, margin, FX or broker-specific facilities. Existing balances are treated as settled opening funds; historical trades are not retroactively locked. Unknown future calendars keep new outstanding proceeds pending until calendar data is updated.
  • Rule references: HKEX settlement and half-days, SEC T+1, DTC 2026 holidays.
Professional technical analysis
  • Trend indicators: moving-average alignment, MACD crosses, and Bollinger Band breakouts.
  • Momentum indicators: RSI overbought/oversold conditions and KDJ saturation or divergence.
  • Price and volume: volume-ratio anomalies, low-volume pullbacks, and high-volume breakouts.
  • Pattern recognition: hammer, engulfing, doji, and other candlestick patterns.
  • Support and resistance: automatic calculation of multiple support and resistance levels.
Price alerts
  • Combine price, percentage change, turnover, volume ratio, and other conditions with AND/OR logic.
  • Limit rules to market hours or keep them active all day on trading days; configure cooldowns, daily trigger limits, and repeat behavior.
  • Set an expiration date and HH:mm time in the rule dialog, or leave it empty so the rule never expires.
  • Choose notification channels per rule, or use the system default when none is selected.
Environment variables
Variable Description Default
AUTH_USERNAME Preconfigured login username Set on first visit
AUTH_PASSWORD Preconfigured login password Set on first visit
JWT_SECRET Secret used to sign JWTs Generated automatically
DATA_DIR Data storage directory ./data
TZ Deployment timezone for Agent schedules and notification quiet hours; interface display/input use the browser timezone Asia/Shanghai
PLAYWRIGHT_SKIP_BROWSER_INSTALL Skip the initial Chromium installation when browser features are not required Not set
LOG_LEVEL Console log level. INFO prints business events and errors; use DEBUG for scheduler heartbeats, collection steps, and other diagnostics. The UI log panel always retains the complete log. INFO
HTTP_PROXY / HTTPS_PROXY / http_proxy Outbound HTTP proxy. Configure it through an external environment variable, http_proxy=http://host:port in .env, or Settings → Global HTTP Proxy. Priority: external environment variables > UI > .env. NO_PROXY includes localhost,127.0.0.1 by default. Not set
OTEL_EXPORTER_OTLP_ENDPOINT OpenTelemetry OTLP endpoint, such as http://jaeger:4318. Export remains completely disabled when this is empty. The optional dependencies in requirements-otel.txt are also required. Not set (disabled)
Local development

Requirements: Python 3.11+ / Node.js 24.14.0 / pnpm 9.15.9

# One-command development setup (recommended)
make dev-api          # Backend with automatic venv/dependencies on :8000
make dev-web          # Frontend with automatic pnpm install on :5183

# Or start each service manually
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python server.py                              # Backend on :8000

cd frontend && pnpm install && pnpm dev       # Frontend on :5183

The frontend development server runs at http://localhost:5183 and proxies /api to 127.0.0.1:8000.

Frontend UI conventions and checks

Technology stack

Backend: FastAPI / SQLAlchemy / APScheduler / OpenAI SDK

Frontend: React 18 / TypeScript / Tailwind CSS / shadcn/ui

OpenTelemetry export (optional and disabled by default)

PanWatch includes a built-in observability stack with structured logs, end-to-end trace_id correlation, the agent_runs table, and node-level TradingAgents progress and cost reporting. It works without any external service.

You can optionally add standard OpenTelemetry export and send traces to Jaeger, Tempo, Langfuse, or another compatible APM. PanWatch maps three types of spans:

  • One agent run → a root span correlated with the trace_id from agent_runs.
  • One LLM call → a gen_ai child span following the OpenTelemetry GenAI semantic conventions, including gen_ai.system, gen_ai.request.model, input/output token usage, and gen_ai.operation.name.
  • One TradingAgents node → a child span that reuses the node-level progress callback.

Export is a complete no-op when the optional dependencies are not installed and no endpoint is configured.

Enable it in three steps:

# 1. Install the optional dependencies
pip install -r requirements-otel.txt

# 2. Configure your collector or APM endpoint
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
export OTEL_SERVICE_NAME=panwatch   # Optional; defaults to panwatch

# 3. Start PanWatch normally. The startup log will confirm that OTel export is enabled.
python server.py

Run a local Jaeger instance to verify the integration:

docker run -d --name jaeger -p 16686:16686 -p 4318:4318 \
  jaegertracing/all-in-one:latest
# Trigger an agent, open http://localhost:16686, and select service=panwatch.

Langfuse and Tempo work the same way: point OTEL_EXPORTER_OTLP_ENDPOINT to their OTLP endpoint.

Publishing Docker images

The repository includes a GitHub Actions release workflow:

  • Pushing a tag such as 0.2.3 automatically builds and publishes:
    • sunxiao0721/panwatch:0.2.3
    • sunxiao0721/panwatch:latest
  • The workflow can also be started manually with workflow_dispatch and an explicit version.

Configure these repository secrets before publishing:

  • DOCKERHUB_USERNAME
  • DOCKERHUB_TOKEN

Support the Project

Sponsorship

For sponsorship or partnership inquiries, contact [email protected].

Donations

PanWatch is free and open source. If it saves you time or improves your workflow, you can support continued development:

PayPal Ko-fi

Alipay / WeChat Pay
Alipay WeChat Pay
Alipay QR code WeChat Pay QR code
USDT

Binance Pay — scan with the Binance app:

Binance Pay QR code

On-chain USDT (TRC20) — scan with any TRON wallet:

Address: TKBV69B2AoU67p3vDhnJUbMJtZ1DxuUF5C

USDT TRC20 address QR code

Contributing

Issues and pull requests are welcome. See the contribution guide for setup, validation, internationalization, custom agents, and market-data sources.

Community chat (Telegram): t.me/panwatch

License

MIT

View on GitHub

Recent activity

commits and pull requests

Recent open issues

view all

Releases and announcements

67 total
  1. 0.20.40.20.4Nov 8, 2026

    ## Docker - sunxiao0721/panwatch:0.20.4 - sunxiao0721/panwatch:latest ## Commits Compare: https://github.com/TNT-Likely/PanWatch/compare/0.20.3...0.20.4 Changes since 0.20.3: - fix(research): recover context limits and validate completion (#278) (97f1813)

  2. 0.20.30.20.3Nov 4, 202619 downloads

    ## Docker - sunxiao0721/panwatch:0.20.3 - sunxiao0721/panwatch:latest ## Commits Compare: https://github.com/TNT-Likely/PanWatch/compare/0.20.2...0.20.3 Changes since 0.20.2: - fix(research): disable default budgets and recover truncated output (#274) (85e23f2) - docs(readme): add Japanese README (#272) (ee40cc5)

  3. 0.20.20.20.2Oct 30, 2026

    ## Docker - sunxiao0721/panwatch:0.20.2 - sunxiao0721/panwatch:latest ## Commits Compare: https://github.com/TNT-Likely/PanWatch/compare/0.20.1...0.20.2 Changes since 0.20.1: - fix(research): enforce JSON mode on every candidate and repair per role (#269) (c4b7b23)

  4. 0.20.10.20.1Oct 30, 2026

    ## Docker - sunxiao0721/panwatch:0.20.1 - sunxiao0721/panwatch:latest ## Commits Compare: https://github.com/TNT-Likely/PanWatch/compare/0.20.0...0.20.1 Changes since 0.20.0: - fix(research): raise model output and total token budget defaults (#268) (8510173) - docs(readme): remove expired research migration announcement (#266) (9817947) - docs(readme): add 88api sponsor section (#265) (1c272a8)

  5. 0.20.00.20.0Oct 23, 2026

    ## Docker - sunxiao0721/panwatch:0.20.0 - sunxiao0721/panwatch:latest ## Commits Compare: https://github.com/TNT-Likely/PanWatch/compare/0.19.0...0.20.0 Changes since 0.19.0: - refactor(portfolio): extract the holding editor dialog (#263) (ec3e87e) - refactor(portfolio): extract account and news dialogs and shared contracts (#262) (c348d28) - perf(frontend): bound requests and load translations on demand (#261) (9a3e13a) - fix(runtime): isolate storage and provider state and correct backtest accounting (#260) (5c7d770) - feat(tradingagents): upgrade analysis and add visual reading (#259) (f744038) - fix(marketdata): read yfinance fast_info mapping keys (#256) (ebc62fa)

Code frequency

additions and deletions
+54.1K-54.1KWeek of 2026-01-25: +32,021 linesWeek of 2026-01-25: -5,571 linesWeek of 2026-02-01: +0 linesWeek of 2026-02-01: -0 linesWeek of 2026-02-08: +35,533 linesWeek of 2026-02-08: -11,261 linesWeek of 2026-02-15: +0 linesWeek of 2026-02-15: -0 linesWeek of 2026-02-22: +0 linesWeek of 2026-02-22: -0 linesWeek of 2026-03-01: +3 linesWeek of 2026-03-01: -2 linesWeek of 2026-03-08: +104 linesWeek of 2026-03-08: -19 linesWeek of 2026-03-15: +0 linesWeek of 2026-03-15: -0 linesWeek of 2026-03-22: +3,081 linesWeek of 2026-03-22: -70 linesWeek of 2026-03-29: +73 linesWeek of 2026-03-29: -18 linesWeek of 2026-04-05: +722 linesWeek of 2026-04-05: -24 linesWeek of 2026-04-12: +1,551 linesWeek of 2026-04-12: -137 linesWeek of 2026-04-19: +0 linesWeek of 2026-04-19: -0 linesWeek of 2026-04-26: +0 linesWeek of 2026-04-26: -0 linesWeek of 2026-05-03: +0 linesWeek of 2026-05-03: -0 linesWeek of 2026-05-10: +6,883 linesWeek of 2026-05-10: -375 linesWeek of 2026-05-17: +2,842 linesWeek of 2026-05-17: -59 linesWeek of 2026-05-24: +0 linesWeek of 2026-05-24: -0 linesWeek of 2026-05-31: +4,014 linesWeek of 2026-05-31: -647 linesWeek of 2026-06-07: +0 linesWeek of 2026-06-07: -0 linesWeek of 2026-06-14: +6,917 linesWeek of 2026-06-14: -2,617 linesWeek of 2026-06-21: +3,853 linesWeek of 2026-06-21: -197 linesWeek of 2026-06-28: +465 linesWeek of 2026-06-28: -13 linesWeek of 2026-07-05: +0 linesWeek of 2026-07-05: -0 linesWeek of 2026-07-12: +9,675 linesWeek of 2026-07-12: -4,205 linesWeek of 2026-07-19: +0 linesWeek of 2026-07-19: -0 linesWeek of 2026-07-26: +0 linesWeek of 2026-07-26: -0 linesWeek of 2026-08-02: +1,052 linesWeek of 2026-08-02: -215 linesWeek of 2026-08-09: +531 linesWeek of 2026-08-09: -18 linesWeek of 2026-08-16: +0 linesWeek of 2026-08-16: -0 linesWeek of 2026-08-23: +6,412 linesWeek of 2026-08-23: -291 linesWeek of 2026-08-30: +1,607 linesWeek of 2026-08-30: -194 linesWeek of 2026-09-06: +54,094 linesWeek of 2026-09-06: -40,888 linesWeek of 2026-09-13: +6,591 linesWeek of 2026-09-13: -342 linesWeek of 2026-09-20: +7,133 linesWeek of 2026-09-20: -5,203 linesWeek of 2026-09-27: +26,971 linesWeek of 2026-09-27: -10,195 linesWeek of 2026-10-04: +6,916 linesWeek of 2026-10-04: -546 linesWeek of 2026-10-11: +3,834 linesWeek of 2026-10-11: -498 linesWeek of 2026-10-18: +9,666 linesWeek of 2026-10-18: -4,038 linesWeek of 2026-10-25: +204 linesWeek of 2026-10-25: -69 linesWeek of 2026-11-01: +635 linesWeek of 2026-11-01: -71 linesWeek of 2026-11-08: +880 linesWeek of 2026-11-08: -70 linesJan 25, 2026Nov 8, 2026
+234.3K lines added, -87.9K removed over the last year.

Commits per week

last 52 weeks
520Week of 2025-11-16: 0 commitsWeek of 2025-11-23: 0 commitsWeek of 2025-11-30: 0 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 0 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 0 commitsWeek of 2026-01-11: 0 commitsWeek of 2026-01-18: 0 commitsWeek of 2026-01-25: 46 commitsWeek of 2026-02-01: 0 commitsWeek of 2026-02-08: 52 commitsWeek of 2026-02-15: 0 commitsWeek of 2026-02-22: 0 commitsWeek of 2026-03-01: 2 commitsWeek of 2026-03-08: 2 commitsWeek of 2026-03-15: 0 commitsWeek of 2026-03-22: 7 commitsWeek of 2026-03-29: 3 commitsWeek of 2026-04-05: 2 commitsWeek of 2026-04-12: 4 commitsWeek of 2026-04-19: 0 commitsWeek of 2026-04-26: 0 commitsWeek of 2026-05-03: 0 commitsWeek of 2026-05-10: 8 commitsWeek of 2026-05-17: 4 commitsWeek of 2026-05-24: 0 commitsWeek of 2026-05-31: 15 commitsWeek of 2026-06-07: 0 commitsWeek of 2026-06-14: 37 commitsWeek of 2026-06-21: 7 commitsWeek of 2026-06-28: 1 commitsWeek of 2026-07-05: 0 commitsWeek of 2026-07-12: 1 commitsWeek of 2026-07-19: 0 commitsWeek of 2026-07-26: 0 commitsWeek of 2026-08-02: 1 commitsWeek of 2026-08-09: 2 commitsWeek of 2026-08-16: 0 commitsWeek of 2026-08-23: 1 commitsWeek of 2026-08-30: 2 commitsWeek of 2026-09-06: 4 commitsWeek of 2026-09-13: 5 commitsWeek of 2026-09-20: 8 commitsWeek of 2026-09-27: 20 commitsWeek of 2026-10-04: 12 commitsWeek of 2026-10-11: 7 commitsWeek of 2026-10-18: 9 commitsWeek of 2026-10-25: 4 commitsWeek of 2026-11-01: 2 commitsWeek of 2026-11-08: 1 commitsNov 16, 2025Nov 8, 2026
269 commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 2 commitsSun 1:00 — 0 commitsSun 2:00 — 1 commitsSun 3:00 — 0 commitsSun 4:00 — 0 commitsSun 5:00 — 0 commitsSun 6:00 — 0 commitsSun 7:00 — 2 commitsSun 8:00 — 1 commitsSun 9:00 — 2 commitsSun 10:00 — 5 commitsSun 11:00 — 4 commitsSun 12:00 — 6 commitsSun 13:00 — 0 commitsSun 14:00 — 0 commitsSun 15:00 — 1 commitsSun 16:00 — 2 commitsSun 17:00 — 2 commitsSun 18:00 — 2 commitsSun 19:00 — 3 commitsSun 20:00 — 11 commitsSun 21:00 — 2 commitsSun 22:00 — 4 commitsSun 23:00 — 7 commitsMon 0:00 — 5 commitsMon 1:00 — 3 commitsMon 2:00 — 0 commitsMon 3:00 — 0 commitsMon 4:00 — 0 commitsMon 5:00 — 0 commitsMon 6:00 — 0 commitsMon 7:00 — 0 commitsMon 8:00 — 1 commitsMon 9:00 — 2 commitsMon 10:00 — 8 commitsMon 11:00 — 4 commitsMon 12:00 — 3 commitsMon 13:00 — 1 commitsMon 14:00 — 2 commitsMon 15:00 — 3 commitsMon 16:00 — 3 commitsMon 17:00 — 1 commitsMon 18:00 — 4 commitsMon 19:00 — 3 commitsMon 20:00 — 2 commitsMon 21:00 — 0 commitsMon 22:00 — 3 commitsMon 23:00 — 1 commitsTue 0:00 — 3 commitsTue 1:00 — 0 commitsTue 2:00 — 0 commitsTue 3:00 — 0 commitsTue 4:00 — 0 commitsTue 5:00 — 0 commitsTue 6:00 — 0 commitsTue 7:00 — 0 commitsTue 8:00 — 1 commitsTue 9:00 — 0 commitsTue 10:00 — 2 commitsTue 11:00 — 0 commitsTue 12:00 — 1 commitsTue 13:00 — 0 commitsTue 14:00 — 3 commitsTue 15:00 — 4 commitsTue 16:00 — 2 commitsTue 17:00 — 5 commitsTue 18:00 — 3 commitsTue 19:00 — 1 commitsTue 20:00 — 1 commitsTue 21:00 — 0 commitsTue 22:00 — 2 commitsTue 23:00 — 0 commitsWed 0:00 — 0 commitsWed 1:00 — 0 commitsWed 2:00 — 0 commitsWed 3:00 — 0 commitsWed 4:00 — 0 commitsWed 5:00 — 0 commitsWed 6:00 — 0 commitsWed 7:00 — 0 commitsWed 8:00 — 1 commitsWed 9:00 — 1 commitsWed 10:00 — 1 commitsWed 11:00 — 3 commitsWed 12:00 — 0 commitsWed 13:00 — 1 commitsWed 14:00 — 0 commitsWed 15:00 — 1 commitsWed 16:00 — 0 commitsWed 17:00 — 1 commitsWed 18:00 — 1 commitsWed 19:00 — 0 commitsWed 20:00 — 4 commitsWed 21:00 — 2 commitsWed 22:00 — 0 commitsWed 23:00 — 1 commitsThu 0:00 — 0 commitsThu 1:00 — 0 commitsThu 2:00 — 0 commitsThu 3:00 — 0 commitsThu 4:00 — 0 commitsThu 5:00 — 0 commitsThu 6:00 — 0 commitsThu 7:00 — 0 commitsThu 8:00 — 2 commitsThu 9:00 — 0 commitsThu 10:00 — 1 commitsThu 11:00 — 2 commitsThu 12:00 — 1 commitsThu 13:00 — 0 commitsThu 14:00 — 3 commitsThu 15:00 — 5 commitsThu 16:00 — 5 commitsThu 17:00 — 7 commitsThu 18:00 — 7 commitsThu 19:00 — 9 commitsThu 20:00 — 7 commitsThu 21:00 — 12 commitsThu 22:00 — 2 commitsThu 23:00 — 0 commitsFri 0:00 — 4 commitsFri 1:00 — 0 commitsFri 2:00 — 0 commitsFri 3:00 — 0 commitsFri 4:00 — 0 commitsFri 5:00 — 0 commitsFri 6:00 — 0 commitsFri 7:00 — 0 commitsFri 8:00 — 0 commitsFri 9:00 — 0 commitsFri 10:00 — 3 commitsFri 11:00 — 3 commitsFri 12:00 — 0 commitsFri 13:00 — 2 commitsFri 14:00 — 0 commitsFri 15:00 — 0 commitsFri 16:00 — 2 commitsFri 17:00 — 8 commitsFri 18:00 — 1 commitsFri 19:00 — 0 commitsFri 20:00 — 0 commitsFri 21:00 — 0 commitsFri 22:00 — 1 commitsFri 23:00 — 0 commitsSat 0:00 — 0 commitsSat 1:00 — 1 commitsSat 2:00 — 4 commitsSat 3:00 — 0 commitsSat 4:00 — 0 commitsSat 5:00 — 0 commitsSat 6:00 — 0 commitsSat 7:00 — 0 commitsSat 8:00 — 0 commitsSat 9:00 — 0 commitsSat 10:00 — 2 commitsSat 11:00 — 1 commitsSat 12:00 — 0 commitsSat 13:00 — 2 commitsSat 14:00 — 0 commitsSat 15:00 — 0 commitsSat 16:00 — 0 commitsSat 17:00 — 4 commitsSat 18:00 — 3 commitsSat 19:00 — 7 commitsSat 20:00 — 2 commitsSat 21:00 — 0 commitsSat 22:00 — 3 commitsSat 23:00 — 3 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.

Who is committing

last 52 weeks
Maintainer commits280 (98%)
Community commits7 (2%)

287 commits in total over the last year.

DateListRankStars gained
Sep 24, 2026daily#15+175
Sep 23, 2026daily#15+175
  • public-apis/public-apis

    A collective list of free APIs

    500.5K stars · Python

  • morluto/rea

    Reverse engineer anything with agents, from app behavior down to native binaries.

    471.6K stars · TypeScript

  • openclaw/openclaw

    The AI that really does things. Any OS. Any Platform. The lobster way. 🦞

    394.9K stars · TypeScript

  • donnemartin/system-design-primer

    Learn how to design large-scale systems. Prep for the system design interview. Includes Anki flashcards.

    378.7K stars · Python

  • awesome-selfhosted/awesome-selfhosted

    A list of Free Software network services and web applications which can be hosted on your own servers

    339K stars

  • obra/superpowers

    An agentic skills framework & software development methodology that works.

    322.9K stars · Shell