# letchat

**Repository Path**: xusk/letchat

## Basic Information

- **Project Name**: letchat
- **Description**: 一个基于多智能体架构的金融分析系统，提供全面的金融市场分析、风险评估和投资建议服务。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-08-01
- **Last Updated**: 2025-08-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 金融智能体系统 (Financial Agent System)

一个基于多智能体架构的金融分析系统，提供全面的金融市场分析、风险评估和投资建议服务。

## 项目架构

```mermaid
graph TD
    A[Chainlit Web界面] --> B[智能体网关]
    B --> C[主控Agent]
    C --> D[基本面研究]
    C --> E[行业研究]
    C --> F[宏观研究]
    C --> G[市场观察员]
    C --> H[风控师]
    C --> I[顾问]
    D --> J[检索模块]
    E --> J
    F --> J
    G --> J
    H --> J
    I --> J
    J --> K[ChromaDB向量库]
    D --> L[数据库模块]
    E --> L
    F --> L
    L --> M[SQL数据库]
    C --> N[记忆模块]
    N --> O[Redis]
    C --> P[LiteLLM模型网关]
    P --> Q[GPT-4]
    P --> R[Claude]
    P --> S[Llama3]
```

## 项目结构

```
financial-agent-system/
├── src/                    # 源代码目录
│   ├── agents/            # 智能体模块
│   │   ├── base.py        # 基础智能体
│   │   ├── orchestrator_agent.py  # 主控智能体
│   │   └── research/      # 研究类智能体
│   │       ├── __init__.py
│   │       ├── fundamental.py
│   │       ├── industry.py
│   │       ├── macro.py
│   │       ├── market.py
│   │       ├── risk.py
│   │       └── advisor.py
│   ├── core/              # 核心模块
│   │   ├── memory.py
│   │   ├── knowledge_base.py
│   │   ├── database.py
│   │   └── llm_config.py
│   ├── workflow/          # 工作流模块
│   │   └── agent_workflow.py
│   ├── mcp/               # MCP服务模块
│   │   └── server.py
│   └── app.py             # 主应用
├── tests/                 # 测试目录
│   ├── agents/
│   ├── core/
│   └── workflow/
├── docker/                # Docker相关文件
│   ├── docker-compose.yml
│   ├── Dockerfile.web
│   ├── Dockerfile.agent
│   └── Dockerfile.mcp
├── config/                # 配置文件
│   ├── config.yaml
│   └── .env
├── requirements/          # 依赖文件
│   ├── requirements.txt
│   └── requirements-mcp.txt
└── docs/                  # 文档
    └── financial_agent_architecture.md
```

## 核心功能

### 1. 基本面研究Agent
- 财务报表分析（资产负债表、利润表、现金流量表）
- 财务比率计算（PE/PB/ROE/负债率等）
- 估值模型（DCF模型、相对估值法）

### 2. 行业研究Agent
- 行业生命周期分析
- 波特五力竞争模型
- 产业链分析

### 3. 宏观研究Agent
- 经济指标分析（CPI/PPI/PMI等）
- 货币政策跟踪
- 国际形势影响评估

### 4. 市场观察员Agent
- 实时行情监控
- 异常交易检测
- 市场情绪分析

### 5. 风控师Agent
- 风险评估和预警
- 市场风险（波动性、流动性风险）
- 信用风险（交易对手风险）

### 6. 顾问Agent
- 投资建议生成
- 投资评级（买入/持有/卖出）
- 仓位管理建议

## 部署方式

### Docker Compose部署

```bash
# 构建Agent镜像
docker build -t langchain-agent .

# 启动服务
docker-compose up -d

# 初始化数据库
docker-compose exec db psql -U user -d finance -f /app/init.sql
```

### 监控方案
- Prometheus + Grafana监控容器资源
- ELK日志收集系统
- 健康检查端点：`/healthz`

## 环境变量配置

在 `.env` 文件中配置以下环境变量：

```env
# API Keys
OPENAI_API_KEY=your_openai_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key
GEMINI_API_KEY=your_gemini_api_key

# Service connections
REDIS_URL=redis://localhost:6379
CHROMA_URL=http://localhost:8000
DB_URL=postgresql://user:pass@localhost:5432/finance
```

## 依赖安装

```bash
# 安装核心依赖
pip install -r requirements/requirements.txt

# 安装MCP服务依赖
pip install -r requirements/requirements-mcp.txt
```

## 测试

```bash
# 运行单元测试
python -m pytest tests/

# 运行特定模块测试
python -m pytest tests/agents/test_research/
```

## MCP服务封装

系统通过MCP（Model Context Protocol）服务封装，支持以下工具：

- `fundamental_analysis`: 公司基本面分析
- `industry_analysis`: 行业研究分析
- `macro_analysis`: 宏观经济分析
- `market_observation`: 市场观察
- `risk_assessment`: 投资风险评估
- `investment_advice`: 投资建议生成
- `full_analysis`: 全流程金融分析

## 贡献指南

1. Fork 项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情