Summary

PA Agent is a desktop AI-assisted decision tool for subjective traders, applying Price Action frameworks. It processes structured K-line data and pre-calculated features via a two-stage AI analysis (market diagnosis, trading decision), offering verifiable paths without broker integration or screenshot analysis.

How It Works

The tool ingests OHLCV K-line data from MT5, TradingView, yfinance, and AkShare. It locally computes technical indicators (EMA20, ATR14) and geometric K-line features. This numerical data, combined with prompt engineering, is sent to an LLM (OpenAI-compatible APIs). The LLM performs a two-stage analysis: diagnosing market conditions (period, direction, bar-by-bar summaries) and generating trading decisions (entry, stop-loss, take-profit references). Output is structured JSON, visualized on the GUI, featuring signal chain validation and AI response retry mechanisms.

Quick Start & Requirements

• Primary Install/Run: Clone repo, create/activate Python 3.11+ venv, pip install -e ".[dev]", then python -m pa_agent.main.
• Prerequisites: Windows 10/11 (primary) or macOS 12+ (specific setup). Requires configuring at least one data source (MT5, TradingView, yfinance, AkShare). API keys are encrypted locally.
• Links: PA_Agent使用文档.md, MAC版本智能体部署方法.txt.

Highlighted Details

• Supports multiple data sources: MT5 (real-time), TradingView, yfinance (futures/crypto), AkShare (A-shares).
• Features a two-stage AI analysis pipeline: market diagnosis and trading decision generation.
• Includes interactive, cyberpunk-style decision tree visualization and future trend predictions.
• Offers incremental analysis for new bars and a free-form chat interface for post-analysis queries.
• Secures API keys locally via DPAPI (Windows) or cryptography (macOS).

Maintenance & Community

• Community support via QQ Group: 871156180.

Licensing & Compatibility

• License: AGPL-3.0. This strong copyleft license requires derivative works to be shared under the same license, potentially impacting integration with closed-source commercial applications.

Limitations & Caveats

• Linux platform unverified; macOS requires specific setup.
• yfinance data has ~15-minute delay for historical daily data.
• The tool is an assistant, not an automated trading system; it does not connect to brokers or execute trades.
• AGPL-3.0 license imposes significant obligations on redistribution and modification.