Update README and add requirements

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
zln
2026-02-26 19:25:40 +08:00
parent 32723fd4b0
commit 669915de04
2 changed files with 99 additions and 0 deletions

View File

@@ -0,0 +1,72 @@
# CardioAI - 心血管疾病智能辅助系统
## 项目概述
本项目是一个多模块应用,集成了数据可视化(Streamlit)、机器学习预测(XGBoost/Flask)和AI语音问答(DeepSeek/cosyVoice)。
## 项目结构
```
.
├── data/ # 数据目录
├── module1_dashboard/ # 模块1: 数据可视化仪表板(Streamlit)
├── module2_predictor/ # 模块2: 机器学习预测器(Flask)
│ └── templates/ # Flask模板目录
├── module3_voice_assistant/ # 模块3: AI语音问答系统
│ └── templates/ # 语音助手模板目录
├── requirements.txt # 项目依赖
└── README.md # 项目说明
```
## 环境配置
### 1. 创建Conda虚拟环境
```bash
conda create -n cardioenv python=3.10
conda activate cardioenv
```
### 2. 安装依赖
```bash
pip install -r requirements.txt
```
### 3. 重要文件路径配置
根据项目要求,以下文件路径需要在本地配置:
- **数据文件**: `/Users/macbook/PycharmProjects/ai_code/data/心血管疾病.xlsx`
- **配置文件**: `/Users/macbook/PycharmProjects/ai_code/.env`
如果路径不存在,请创建相应目录和文件。
## 模块说明
### Module 1: 数据可视化仪表板
- 技术栈: Streamlit + Plotly
- 功能: 心血管疾病数据可视化分析
- 位置: `module1_dashboard/`
### Module 2: 机器学习预测器
- 技术栈: Flask + XGBoost + scikit-learn
- 功能: 心血管疾病风险预测模型
- 位置: `module2_predictor/`
### Module 3: AI语音问答系统
- 技术栈: DeepSeek API + cosyVoice + Flask
- 功能: 智能语音问答助手
- 位置: `module3_voice_assistant/`
## 快速开始
1. 按照"环境配置"步骤设置虚拟环境和安装依赖
2. 将心血管疾病数据文件放置到指定路径
3. 根据需要创建`.env`配置文件包含API密钥等敏感信息
4. 分别运行各模块进行开发测试
## 依赖说明
详细依赖见`requirements.txt`,主要包含:
- 数据处理: pandas, numpy, openpyxl
- 机器学习: scikit-learn, xgboost, joblib
- 可视化: streamlit, plotly
- Web框架: Flask
- AI集成: langchain-openai, dashscope
- 工具库: python-dotenv, requests
## 下一步
各模块的具体实现代码需要根据项目需求进一步开发。

27
requirements.txt Normal file
View File

@@ -0,0 +1,27 @@
# CardioAI - 心血管疾病智能辅助系统
# 环境配置说明:
# 1. 创建conda虚拟环境:
# conda create -n cardioenv python=3.10
# 2. 激活环境:
# conda activate cardioenv
# 3. 安装依赖:
# pip install -r requirements.txt
# 核心依赖
pandas>=2.0.0
openpyxl>=3.1.0
numpy>=1.24.0
scikit-learn>=1.3.0
xgboost>=2.0.0
joblib>=1.3.0
# 可视化与Web框架
streamlit>=1.28.0
plotly>=5.17.0
Flask>=2.3.0
# 环境配置与AI
python-dotenv>=1.0.0
langchain-openai>=0.0.5
dashscope>=1.14.0
requests>=2.31.0