Metadata-Version: 2.4
Name: isage
Version: 0.1.5.1
Summary: SAGE - Streaming-Augmented Generative Execution
Author-email: SAGE Team <shuhao_zhang@hust.edu.cn>
License-Expression: MIT
Project-URL: Homepage, https://github.com/intellistream/SAGE
Project-URL: Documentation, https://intellistream.github.io/SAGE-Pub/
Project-URL: Repository, https://github.com/intellistream/SAGE.git
Project-URL: Bug Tracker, https://github.com/intellistream/SAGE/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Distributed Computing
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: isage-common>=0.1.0
Requires-Dist: isage-kernel>=0.1.0
Requires-Dist: isage-middleware>=0.1.0
Requires-Dist: isage-tools[cli]>=0.1.0
Requires-Dist: isage-libs>=0.1.0
Requires-Dist: numpy<2.3.0,>=1.26.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: matplotlib>=3.4.0
Requires-Dist: scipy<2.0.0,>=1.15.0
Requires-Dist: jupyter>=1.0.0
Requires-Dist: ipykernel>=6.0.0
Provides-Extra: minimal
Requires-Dist: isage-common>=0.1.0; extra == "minimal"
Requires-Dist: isage-kernel>=0.1.0; extra == "minimal"
Provides-Extra: standard
Requires-Dist: isage-middleware>=0.1.0; extra == "standard"
Requires-Dist: isage-libs>=0.1.0; extra == "standard"
Requires-Dist: numpy<2.3.0,>=1.26.0; extra == "standard"
Requires-Dist: pandas>=1.3.0; extra == "standard"
Requires-Dist: matplotlib>=3.4.0; extra == "standard"
Requires-Dist: scipy<2.0.0,>=1.15.0; extra == "standard"
Requires-Dist: jupyter>=1.0.0; extra == "standard"
Requires-Dist: ipykernel>=6.0.0; extra == "standard"
Provides-Extra: dev
Requires-Dist: isage[standard]; extra == "dev"
Requires-Dist: isage-tools[dev]>=0.1.0; extra == "dev"
Requires-Dist: pre-commit>=3.0.0; extra == "dev"

# SAGE - Streaming-Augmented Generative Execution

SAGE (Streaming-Augmented Generative Execution) 是一个强大的分布式流数据处理平台的 Meta 包。

## 简介

这是 SAGE 的主要元包，它会自动安装所有核心 SAGE 组件，为用户提供完整的 SAGE 开发和运行环境。

## 包含的组件

### 核心组件 (默认安装)
- **isage-common**: 基础工具和公共模块
- **isage-kernel**: 核心运行时和任务执行引擎  
- **isage-tools**: CLI命令行工具（包含 `sage` 和 `sage-dev` 命令）

### 可选组件
- **标准安装**: 中间件+应用库+科学计算 (`pip install isage[standard]`)
- **开发工具**: 开发测试工具 (`pip install isage[dev]`)

## 快速开始

### 基础安装（包含核心功能和CLI）
```bash
pip install isage
```

### 标准安装（包含中间件、应用库和科学计算）
```bash
pip install isage[standard]
```

### 开发环境安装
```bash
pip install isage[dev]
```

## 使用示例

```python
import sage

# 创建 SAGE 应用
app = sage.create_app()

# 定义数据流处理
@app.stream("user_events")
def process_events(event):
    return {
        "user_id": event["user_id"],
        "processed_at": sage.now(),
        "result": "processed"
    }

# 启动应用
if __name__ == "__main__":
    app.run()
```

## 命令行工具

安装后，你可以使用以下命令：

```bash
# 查看版本
sage --version

# 创建新项目
sage create my-project

# 启动服务
sage run

# 查看帮助
sage --help
```

## 文档

- [用户指南](https://intellistream.github.io/SAGE-Pub/)
- [API 文档](https://intellistream.github.io/SAGE-Pub/api/)
- [开发者指南](https://intellistream.github.io/SAGE-Pub/dev/)

## 许可证

MIT License

## 贡献

欢迎贡献代码！请查看我们的[贡献指南](CONTRIBUTING.md)。

## 支持

如果你遇到问题或有疑问，请：

1. 查看[文档](https://intellistream.github.io/SAGE-Pub/)
2. 搜索[已知问题](https://github.com/intellistream/SAGE/issues)
3. 创建[新问题](https://github.com/intellistream/SAGE/issues/new)
