Summary

This project offers an intelligent A-share (Chinese stock market) analysis platform, integrating CrewAI for multi-agent collaboration and AKShare for comprehensive data acquisition. It aims to deliver professional investment analysis and decision support by simulating specialized AI roles, targeting technical users, researchers, and power users seeking automated insights into the Chinese stock market.

How It Works

The system utilizes a multi-agent architecture orchestrated by CrewAI, featuring four distinct AI roles: an A-share Market Analyst, a Financial Statement Expert, a Market Sentiment Researcher, and an A-share Investment Advisor. These agents collaborate to perform in-depth analysis, drawing data from AKShare, a professional source for real-time quotes, historical data, financial reports, fund flows, and market sentiment. This approach is specifically designed to cater to the unique characteristics of the Chinese stock market, providing a holistic analytical view.

Quick Start & Requirements

• Environment: Python 3.12+
• Installation: Clone the repository, navigate to the directory, and install dependencies using poetry install --no-root or uv sync.
• Configuration: Copy .env.example to .env and configure necessary parameters.
• Execution: Run analysis via poetry run python src/a_stock_analysis/main.py or the installed script poetry run a_stock_analysis.
• Customization: LLM models (Ollama/OpenAI), agent roles, and task configurations can be adjusted in src/a_stock_analysis/crew.py, config/agents.yaml, and config/tasks.yaml respectively.
• Links: No external documentation or demo links are provided; setup is local.

Highlighted Details

• Data Capabilities: Accesses real-time and historical market data, financial reports, fund flows, industry sectors, and market sentiment indicators.
• Analysis Dimensions: Covers technical analysis (K-lines, indicators), financial analysis (ratios, trends), fund flow analysis (main, Northbound, retail), sentiment analysis (market, policy), and investment advice generation.
• A-share Specific Features: Includes analysis of policy impacts, daily limit effects, retail investor sentiment, and tracking of Chinese-specific fund rotation patterns.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or a public roadmap are present in the provided README.

Licensing & Compatibility

• License: MIT License.
• Compatibility: The MIT license permits broad use, including commercial applications and integration into closed-source projects.

Limitations & Caveats

The system is intended strictly for learning and research purposes and does not constitute investment advice. Users are cautioned about the high risks associated with the A-share market and advised to exercise caution and conduct their own due diligence, as past performance is not indicative of future results.