这是一个基于 AKShare 和 CrewAI 框架的 A 股智能分析系统。它通过四个专业 AI 智能体协作,为你提供包括实时行情、财务数据、资金流向在内的多维度分析。

📋 准备工作

在开始部署前,请确保你的电脑满足以下条件:

  • Python 版本:3.12 或更高版本。
  • 依赖管理工具:推荐使用 PoetryUV(安装步骤会说明)。
  • 大语言模型 (LLM):项目默认使用本地的 Ollama,你也需要提前安装并运行一个模型(如 llama3.1),或者在配置环节切换为 OpenAI 等云端模型。

🛠️ 详细部署步骤

1. 获取项目代码

首先,将项目克隆到你的本地目录:

1
2
git clone https://github.com/liangdabiao/easy_investment_Agent_crewai.git
cd easy_investment_Agent_crewai

注意:原 README 中的目录名 stock_analysis_a_stock 与仓库名不一致,请以实际克隆下来的文件夹为准。

2. 安装项目依赖

项目提供了两种依赖管理方式,任选其一即可:

方式一:使用 Poetry(推荐)

1
poetry install --no-root

方式二:使用 UV

1
uv sync

这个命令会自动创建虚拟环境并安装所有依赖。

3. 配置环境变量

复制项目提供的模板文件,并根据你的实际情况进行编辑:

1
cp .env.example .env

接下来,用文本编辑器打开 .env 文件。如果你使用 OpenAI 等云端模型,需要在这里配置你的 API Key,例如:

1
OPENAI_API_KEY=sk-你的密钥

4. 配置与切换 AI 模型(关键步骤)

系统默认使用本地的 Ollama。如果你没有或不打算使用本地模型,必须修改代码以指向你使用的模型服务。

打开 src/a_stock_analysis/crew.py 文件,找到定义 LLM 的部分。根据你的选择,进行如下修改:

选项 A:继续使用 Ollama(本地)
确保 Ollama 服务正在运行,并已拉取所需模型(如 ollama pull llama3.1)。代码保持默认即可:

1
2
from langchain.llms import Ollama
llm = Ollama(model="llama3.1")

选项 B:切换为 OpenAI GPT(云端)
将代码修改为:

1
2
from langchain.chat_models import ChatOpenAI
llm = ChatOpenAI(model='gpt-4')

同时,请确保 .env 文件中配置了正确的 OPENAI_API_KEY

5. 运行股票分析

一切就绪后,你可以通过以下命令启动分析系统:

1
2
3
4
5
# 运行主程序(默认分析腾讯控股)
poetry run python src/a_stock_analysis/main.py

# 或者,如果你使用 UV
uv run python src/a_stock_analysis/main.py

你也可以使用项目注册的命令来运行:

1
poetry run a_stock_analysis

系统启动后,会依次展示四个 AI 智能体(市场分析师、财务报表专家等)的协作分析过程。

6. 分析其他股票

如果你想分析别的股票,需要修改 main.py 文件中的输入参数。例如,分析贵州茅台,可以修改为:

1
2
3
4
5
inputs = {
'company_name': '贵州茅台',
'stock_code': '600519.SH', # A股代码
'market': 'SH' # SH=上交所, SZ=深交所, HK=港股
}

支持的代码格式为:600519.SH(上交所)、000001.SZ(深交所)。

⚠️ 重要提示

  • 仅供学习:该系统旨在展示多智能体协作的技术应用,其分析结果不构成任何投资建议,请勿直接用于真实交易决策。
  • 费用考虑:如果使用云端大模型(如 GPT-4),请注意 API 调用会产生费用。初期建议使用本地 Ollama 模型进行测试,以节省成本。