# Sage

**Repository Path**: NovemberRain/Sage

## Basic Information

- **Project Name**: Sage
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-11
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 🌟 **体验 Sage 的强大能力**

![logo](assets/logo.png)

[![English](https://img.shields.io/badge/🌍_English-点击查看-yellow?style=for-the-badge)](README.md)
[![简体中文](https://img.shields.io/badge/🇨🇳_简体中文-当前版本-orange?style=for-the-badge)](README_CN.md)
[![License: MIT](https://img.shields.io/badge/📄_许可证-MIT-blue.svg?style=for-the-badge)](LICENSE)
[![Python 3.11+](https://img.shields.io/badge/🐍_Python-3.11+-brightgreen.svg?style=for-the-badge)](https://python.org)
[![Version](https://img.shields.io/badge/🚀_版本-0.9.7-green.svg?style=for-the-badge)](https://github.com/ZHangZHengEric/Sage)

# 🧠 **Sage 多智能体框架**

### 🎯 **让复杂任务变得简单**

> 🌟 **生产级、模块化、智能化的多智能体编排框架，专为复杂问题求解而生。**

</div>

---

## ✨ **核心亮点**

- 🧠 **智能任务分解**：自动将复杂问题分解为可管理的子任务，支持依赖追踪。
- 🔄 **智能体编排**：专业智能体（规划、执行、观察、总结）间的无缝协作。
- 🛠️ **可扩展工具系统**：基于插件的架构，支持 **MCP 服务器** 和自动发现。
- ⚡ **双重模式**：**深度研究模式**用于全面分析，**快速执行模式**用于高效完成。
- 📊 **上下文管理**：先进的 **Context Budget** 控制，实现精准的 Token 优化 (v0.9.7+)。
- 🌐 **现代化 UI**：基于 Vue3 + FastAPI 的 Web 界面，支持实时流式可视化。
- 🐍 **Python 3.11+ 优化**：全类型注解和代码风格检查，确保企业级可靠性。

## 🚀 **快速开始**

### 安装

```bash
git clone https://github.com/ZHangZHengEric/Sage.git
cd Sage
pip install -r requirements.txt
# 如果需要 Web UI
pip install -r app/fastapi_react_demo/requirements.txt
```

### 运行 Sage

**交互式 Web 演示 (Streamlit)**：
```bash
streamlit run app/sage_demo.py -- \
  --default_llm_api_key YOUR_API_KEY \
  --default_llm_model deepseek-chat \
  --default_llm_base_url https://api.deepseek.com
```

**命令行工具 (CLI)**：
```bash
python app/sage_cli.py \
  --default_llm_api_key YOUR_API_KEY \
  --default_llm_model deepseek-chat \
  --default_llm_base_url https://api.deepseek.com
```

**现代化 Web 应用 (FastAPI + React)**：

现代化 Web 应用现在重构为 `app/server` (后端) 和 `app/web` (前端)。

**使用 Docker Compose 部署**：
```bash
docker-compose up -d
```
访问应用地址：`http://localhost:30051`。

## 🤖 **支持的模型**

```mermaid
graph LR
    U[用户输入] --> AC[智能体控制器]
    AC --> WF
    AC --> RM

    subgraph WF[工作流]
        A[分析] --> B[规划] --> C[执行] --> D[观察] --> E[总结]
        D -- "循环" --> B
        C -- 使用 --> X[🛠️ 工具系统]
    end
    E --> R[结果展示]

    subgraph RM[资源与状态管理]
        F[任务管理器]
        G[消息管理器]
        H[工作区]
    end
```

## 📅 **v0.9.7 更新内容**

- **上下文预算 (Context Budget)**：新增参数（`--context_history_ratio` 等），实现细粒度上下文控制。
- **参数统一**：在 Server、CLI 和 Demo 中标准化了 `default_llm_*` 参数。
- **稳定性**：全面符合 Python 3.11+ 类型安全标准，优化代码风格。
- **[查看完整版本发布说明](release_notes/v0.9.7.md)**

## 📚 **文档资源**

- [**完整文档**](docs/README.md)
- [**API 参考**](docs/API_REFERENCE_CN.md)
- [**配置指南**](docs/CONFIGURATION_CN.md)
- [**工具开发**](docs/TOOL_DEVELOPMENT_CN.md)

---
<div align="center">
Built with ❤️ by the Sage Team
</div>