TNT-Likely/PanWatch

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

| Agent | Trigger | Purpose | |-------|---------|---------| | Pre-market outlook | Before each market session | Combines overnight U.S. market moves, news, and technical structure into an action plan for the day. | | Intraday monitor | During trading hours | Watches unusual moves and sends alerts when indicators such as RSI, KDJ, and MACD align. | | Daily report | After market close | Reviews the session, analyzes capital flows, and prepares a plan for the next trading day. |

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

• Markets: real-time quotes for China A-shares, Hong Kong stocks, and U.S. stocks.
• Account management: manage brokerage accounts independently while viewing consolidated total assets.
• Trading styles: set short-term, swing, or long-term preferences for more relevant AI suggestions.

Telegram / WeCom / DingTalk / Feishu / Bark / custom webhooks

• 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; 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.

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

docker compose up -d

| 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 | Application timezone used for agent schedules and displayed times | 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) |

1. Open the web interface and create your login credentials. 2. Go to Settings → AI Services and configure an OpenAI-compatible API, such as OpenAI, Zhipu AI, DeepSeek, or Ollama. 3. Go to Settings → Notification Channels and add Telegram or another delivery channel. 4. Go to Portfolio → Add Stock, add a symbol to your watchlist, and enable the relevant agents.

Requirements: Python 3.10+ / 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.

Port 5183 is used instead of Vite's default 5173 to avoid conflicts with other locally running projects such as BeeCount-Cloud.

Backend: FastAPI / SQLAlchemy / APScheduler / OpenAI SDK

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

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.

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.

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.

• DOCKERHUB_USERNAME
• DOCKERHUB_TOKEN

Address: TKBV69B2AoU67p3vDhnJUbMJtZ1DxuUF5C

| Alipay | WeChat Pay | |:---:|:---:| | | |