This project offers an AI-driven system for automated daily analysis of Chinese A-shares. It targets individual investors seeking automated insights, delivering a "Decision Dashboard" with actionable conclusions and buy/sell points via multiple channels at zero operational cost.

How It Works

The system integrates multiple data sources (AkShare, Tushare, YFinance for market data; Tavily, SerpAPI for news) and leverages Google Gemini (or OpenAI-compatible APIs) for AI analysis. It generates a daily "Decision Dashboard" summarizing technicals, sentiment, and market trends, alongside a market overview. Key advantages include zero-cost deployment via GitHub Actions and free Gemini API utilization.

Quick Start & Requirements

• Installation: Recommended via GitHub Actions (fork, configure secrets, enable Actions). Local setup involves cloning, pip install -r requirements.txt, and configuring .env. Docker deployment is also supported.
• Prerequisites: Requires AI model API keys (GEMINI_API_KEY or OPENAI_API_KEY) and at least one notification channel secret. A STOCK_LIST secret is mandatory. Optional keys include news API keys and TUSHARE_TOKEN.
• Links: Official quick-start guide is within the README.
• Resource Footprint: GitHub Actions offers zero-cost, automated execution. Local/Docker requires standard Python environments.

Highlighted Details

• AI Decision Dashboard: Concise conclusions, precise buy/sell points, checklists.
• Multi-dimensional Analysis: Integrates technicals, fund flows, sentiment, and real-time quotes.
• Zero-Cost Deployment: Runs entirely on GitHub Actions.
• Free AI Integration: Utilizes free tiers of Google Gemini and supports OpenAI-compatible models.
• Extensive Notifications: Supports WeChat, Feishu, Telegram, Email, and custom webhooks.
• Built-in Trading Logic: Enforces principles like avoiding chasing highs.

Maintenance & Community

Maintained by ZhuLinsen, with a roadmap detailing planned features like expanded notifications, AI models, data sources, and a Web UI. Contributions via Issues and Pull Requests are welcomed.

Licensing & Compatibility

Released under the MIT License, permitting broad use, modification, and distribution, including for commercial purposes, with attribution.

Limitations & Caveats

Actively under development with planned features (e.g., iOS/Android push, specific AI models, Web UI, backtesting). Reliability depends on free third-party API stability. The system explicitly disclaims providing investment advice.