isage 0.2.4.18__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- isage-0.2.4.18/MANIFEST.in +7 -0
- isage-0.2.4.18/PKG-INFO +235 -0
- isage-0.2.4.18/README.md +200 -0
- isage-0.2.4.18/pyproject.toml +81 -0
- isage-0.2.4.18/setup.cfg +4 -0
- isage-0.2.4.18/setup.py +9 -0
- isage-0.2.4.18/src/isage.egg-info/PKG-INFO +235 -0
- isage-0.2.4.18/src/isage.egg-info/SOURCES.txt +15 -0
- isage-0.2.4.18/src/isage.egg-info/dependency_links.txt +1 -0
- isage-0.2.4.18/src/isage.egg-info/requires.txt +18 -0
- isage-0.2.4.18/src/isage.egg-info/top_level.txt +1 -0
- isage-0.2.4.18/src/sage/__init__.py +20 -0
- isage-0.2.4.18/src/sage/__init__.pyc +0 -0
- isage-0.2.4.18/src/sage/__pycache__/__init__.cpython-311.pyc +0 -0
- isage-0.2.4.18/src/sage/__pycache__/_version.cpython-311.pyc +0 -0
- isage-0.2.4.18/src/sage/_version.py +6 -0
- isage-0.2.4.18/src/sage/_version.pyc +0 -0
isage-0.2.4.18/PKG-INFO
ADDED
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: isage
|
|
3
|
+
Version: 0.2.4.18
|
|
4
|
+
Summary: SAGE - Streaming-Augmented Generative Execution
|
|
5
|
+
Author-email: SAGE Team <shuhao_zhang@hust.edu.cn>
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/intellistream/SAGE
|
|
8
|
+
Project-URL: Documentation, https://intellistream.github.io/SAGE-Pub/
|
|
9
|
+
Project-URL: Repository, https://github.com/intellistream/SAGE.git
|
|
10
|
+
Project-URL: Bug Tracker, https://github.com/intellistream/SAGE/issues
|
|
11
|
+
Classifier: Development Status :: 4 - Beta
|
|
12
|
+
Classifier: Intended Audience :: Developers
|
|
13
|
+
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
14
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
15
|
+
Classifier: Topic :: System :: Distributed Computing
|
|
16
|
+
Requires-Python: ==3.11.*
|
|
17
|
+
Description-Content-Type: text/markdown
|
|
18
|
+
Requires-Dist: isage-common>=0.2.4.13
|
|
19
|
+
Requires-Dist: isagellm>=0.5.1.2
|
|
20
|
+
Requires-Dist: isage-platform>=0.1.0
|
|
21
|
+
Requires-Dist: isage-kernel>=0.2.4.14
|
|
22
|
+
Requires-Dist: isage-libs>=0.1.0
|
|
23
|
+
Requires-Dist: isage-middleware>=0.1.0
|
|
24
|
+
Requires-Dist: isage-flownet>=0.1.0
|
|
25
|
+
Requires-Dist: isage-cli>=0.2.4.13
|
|
26
|
+
Provides-Extra: dev
|
|
27
|
+
Requires-Dist: isage-tools>=0.1.0; extra == "dev"
|
|
28
|
+
Requires-Dist: pytest>=7.4.0; extra == "dev"
|
|
29
|
+
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
|
|
30
|
+
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
|
|
31
|
+
Requires-Dist: ruff==0.14.6; extra == "dev"
|
|
32
|
+
Requires-Dist: mypy>=1.7.0; extra == "dev"
|
|
33
|
+
Requires-Dist: pre-commit>=3.5.0; extra == "dev"
|
|
34
|
+
Requires-Dist: isage-pypi-publisher>=0.2.0; extra == "dev"
|
|
35
|
+
|
|
36
|
+
# SAGE - Streaming-Augmented Generative Execution
|
|
37
|
+
|
|
38
|
+
SAGE (Streaming-Augmented Generative Execution) 是一个强大的分布式流数据处理平台的 Meta 包。
|
|
39
|
+
|
|
40
|
+
## ⚠️ PEP 420 Namespace Package
|
|
41
|
+
|
|
42
|
+
**CRITICAL**: SAGE 使用 PEP 420 namespace packages 架构。
|
|
43
|
+
|
|
44
|
+
```python
|
|
45
|
+
# ❌ 错误:不能直接导入 sage 命名空间
|
|
46
|
+
import sage
|
|
47
|
+
|
|
48
|
+
# ✅ 正确:导入具体的子包
|
|
49
|
+
import sage.common
|
|
50
|
+
import sage.kernel
|
|
51
|
+
import sage.middleware
|
|
52
|
+
from sage.common.config import get_user_paths
|
|
53
|
+
|
|
54
|
+
# 注意: sage.llm 已移至独立仓库 isagellm
|
|
55
|
+
# pip install isagellm
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
**为什么不能直接 `import sage`?**
|
|
59
|
+
|
|
60
|
+
- SAGE 采用 PEP 420 原生命名空间(无 `__init__.py`)
|
|
61
|
+
- 允许多个独立 PyPI 包共享 `sage.*` 命名空间
|
|
62
|
+
- 防止"命名空间劫持"(首个安装包独占 `sage/`)
|
|
63
|
+
- 符合现代 Python 标准(Python 3.3+)
|
|
64
|
+
|
|
65
|
+
**相关**: #1388 多仓库拆分准备
|
|
66
|
+
|
|
67
|
+
## 简介
|
|
68
|
+
|
|
69
|
+
这是 SAGE 的主要元包,提供分层的安装选项以适应不同使用场景。
|
|
70
|
+
|
|
71
|
+
## 🧭 Governance / 团队协作制度
|
|
72
|
+
|
|
73
|
+
本包的团队安排、负责人制度、协作流程与质量门槛见:
|
|
74
|
+
|
|
75
|
+
- `docs/governance/TEAM.md`
|
|
76
|
+
- `docs/governance/MAINTAINERS.md`
|
|
77
|
+
- `docs/governance/DEVELOPER_GUIDE.md`
|
|
78
|
+
- `docs/governance/PR_CHECKLIST.md`
|
|
79
|
+
- `docs/governance/SELF_HOSTED_RUNNER.md`
|
|
80
|
+
- `docs/governance/TODO.md`
|
|
81
|
+
|
|
82
|
+
## 🎯 安装方式
|
|
83
|
+
|
|
84
|
+
### 标准安装(推荐)✅
|
|
85
|
+
|
|
86
|
+
日常应用开发,包含核心功能 + CLI + Web UI + RAG/LLM operators
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
pip install isage
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
**包含组件**:
|
|
93
|
+
|
|
94
|
+
- **L1-L4**: 核心运行时、算法库、领域算子
|
|
95
|
+
- **L5**: CLI 工具 (`sage` 命令) + 开发工具
|
|
96
|
+
|
|
97
|
+
**独立仓库** (不在 SAGE 核心架构中):
|
|
98
|
+
|
|
99
|
+
- sage-benchmark - 基准测试
|
|
100
|
+
- sage-examples - 应用示例
|
|
101
|
+
- sage-studio - Web UI
|
|
102
|
+
- sageLLM - LLM 推理引擎
|
|
103
|
+
- **科学计算库**: numpy, pandas, matplotlib, scipy, jupyter
|
|
104
|
+
|
|
105
|
+
**大小**: ~200MB | **适合**: 应用开发者、日常使用
|
|
106
|
+
|
|
107
|
+
______________________________________________________________________
|
|
108
|
+
|
|
109
|
+
### 其他安装选项
|
|
110
|
+
|
|
111
|
+
#### 核心运行时
|
|
112
|
+
|
|
113
|
+
仅用于运行已有 pipeline(生产环境、容器部署)
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
pip install isage[core]
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
**大小**: ~100MB | **适合**: 生产部署
|
|
120
|
+
|
|
121
|
+
#### 完整功能
|
|
122
|
+
|
|
123
|
+
包含示例应用(医疗、视频)和性能测试工具
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
pip install isage[full]
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
**大小**: ~300MB | **适合**: 学习示例、性能评估
|
|
130
|
+
|
|
131
|
+
#### 框架开发
|
|
132
|
+
|
|
133
|
+
修改 SAGE 框架源代码
|
|
134
|
+
|
|
135
|
+
```bash
|
|
136
|
+
pip install isage[dev]
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
**大小**: ~400MB | **适合**: 框架贡献者
|
|
140
|
+
|
|
141
|
+
## 📦 包含的组件
|
|
142
|
+
|
|
143
|
+
### 默认安装 (standard)
|
|
144
|
+
|
|
145
|
+
- **isage-common** (L1): 基础工具和公共模块
|
|
146
|
+
- **isage-platform** (L2): 平台服务(队列、存储)
|
|
147
|
+
- **isage-kernel** (L3): 核心运行时和任务执行引擎
|
|
148
|
+
- **isage-libs** (L3): 算法库和 Agent 框架
|
|
149
|
+
- **isage-middleware** (L4): RAG/LLM operators
|
|
150
|
+
- **isage-tools** (L5): CLI 工具 (`sage` 命令)
|
|
151
|
+
- **isage-cli** (L5): 生产 CLI 接口
|
|
152
|
+
|
|
153
|
+
### 额外组件 (独立仓库/PyPI 包)
|
|
154
|
+
|
|
155
|
+
- **isage-benchmark**: 性能基准测试工具 (独立仓库: sage-benchmark)
|
|
156
|
+
- **isagellm**: LLM 推理引擎 (独立仓库: sageLLM)
|
|
157
|
+
- **isage-edge**: 边缘聚合器 (独立仓库: sage-edge)
|
|
158
|
+
|
|
159
|
+
## 快速开始
|
|
160
|
+
|
|
161
|
+
### 安装
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
# 标准安装(推荐)
|
|
165
|
+
pip install isage
|
|
166
|
+
|
|
167
|
+
# 或从源码安装
|
|
168
|
+
git clone https://github.com/intellistream/SAGE.git
|
|
169
|
+
cd SAGE
|
|
170
|
+
pip install -e packages/sage
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
## 使用示例
|
|
174
|
+
|
|
175
|
+
```python
|
|
176
|
+
import sage
|
|
177
|
+
|
|
178
|
+
# 创建 SAGE 应用
|
|
179
|
+
app = sage.create_app()
|
|
180
|
+
|
|
181
|
+
|
|
182
|
+
# 定义数据流处理
|
|
183
|
+
@app.stream("user_events")
|
|
184
|
+
def process_events(event):
|
|
185
|
+
return {
|
|
186
|
+
"user_id": event["user_id"],
|
|
187
|
+
"processed_at": sage.now(),
|
|
188
|
+
"result": "processed",
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
|
|
192
|
+
# 启动应用
|
|
193
|
+
if __name__ == "__main__":
|
|
194
|
+
app.run()
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
## 命令行工具
|
|
198
|
+
|
|
199
|
+
安装后,你可以使用以下命令:
|
|
200
|
+
|
|
201
|
+
```bash
|
|
202
|
+
# 查看版本
|
|
203
|
+
sage --version
|
|
204
|
+
|
|
205
|
+
# 创建新项目
|
|
206
|
+
sage create my-project
|
|
207
|
+
|
|
208
|
+
# 启动服务
|
|
209
|
+
sage run
|
|
210
|
+
|
|
211
|
+
# 查看帮助
|
|
212
|
+
sage --help
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
## 文档
|
|
216
|
+
|
|
217
|
+
- [用户指南](https://intellistream.github.io/SAGE-Pub/)
|
|
218
|
+
- [API 文档](https://intellistream.github.io/SAGE-Pub/api/)
|
|
219
|
+
- [开发者指南](https://intellistream.github.io/SAGE-Pub/dev/)
|
|
220
|
+
|
|
221
|
+
## 许可证
|
|
222
|
+
|
|
223
|
+
MIT License
|
|
224
|
+
|
|
225
|
+
## 贡献
|
|
226
|
+
|
|
227
|
+
欢迎贡献代码!请查看我们的[贡献指南](CONTRIBUTING.md)。
|
|
228
|
+
|
|
229
|
+
## 支持
|
|
230
|
+
|
|
231
|
+
如果你遇到问题或有疑问,请:
|
|
232
|
+
|
|
233
|
+
1. 查看[文档](https://intellistream.github.io/SAGE-Pub/)
|
|
234
|
+
1. 搜索[已知问题](https://github.com/intellistream/SAGE/issues)
|
|
235
|
+
1. 创建[新问题](https://github.com/intellistream/SAGE/issues/new)
|
isage-0.2.4.18/README.md
ADDED
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
# SAGE - Streaming-Augmented Generative Execution
|
|
2
|
+
|
|
3
|
+
SAGE (Streaming-Augmented Generative Execution) 是一个强大的分布式流数据处理平台的 Meta 包。
|
|
4
|
+
|
|
5
|
+
## ⚠️ PEP 420 Namespace Package
|
|
6
|
+
|
|
7
|
+
**CRITICAL**: SAGE 使用 PEP 420 namespace packages 架构。
|
|
8
|
+
|
|
9
|
+
```python
|
|
10
|
+
# ❌ 错误:不能直接导入 sage 命名空间
|
|
11
|
+
import sage
|
|
12
|
+
|
|
13
|
+
# ✅ 正确:导入具体的子包
|
|
14
|
+
import sage.common
|
|
15
|
+
import sage.kernel
|
|
16
|
+
import sage.middleware
|
|
17
|
+
from sage.common.config import get_user_paths
|
|
18
|
+
|
|
19
|
+
# 注意: sage.llm 已移至独立仓库 isagellm
|
|
20
|
+
# pip install isagellm
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
**为什么不能直接 `import sage`?**
|
|
24
|
+
|
|
25
|
+
- SAGE 采用 PEP 420 原生命名空间(无 `__init__.py`)
|
|
26
|
+
- 允许多个独立 PyPI 包共享 `sage.*` 命名空间
|
|
27
|
+
- 防止"命名空间劫持"(首个安装包独占 `sage/`)
|
|
28
|
+
- 符合现代 Python 标准(Python 3.3+)
|
|
29
|
+
|
|
30
|
+
**相关**: #1388 多仓库拆分准备
|
|
31
|
+
|
|
32
|
+
## 简介
|
|
33
|
+
|
|
34
|
+
这是 SAGE 的主要元包,提供分层的安装选项以适应不同使用场景。
|
|
35
|
+
|
|
36
|
+
## 🧭 Governance / 团队协作制度
|
|
37
|
+
|
|
38
|
+
本包的团队安排、负责人制度、协作流程与质量门槛见:
|
|
39
|
+
|
|
40
|
+
- `docs/governance/TEAM.md`
|
|
41
|
+
- `docs/governance/MAINTAINERS.md`
|
|
42
|
+
- `docs/governance/DEVELOPER_GUIDE.md`
|
|
43
|
+
- `docs/governance/PR_CHECKLIST.md`
|
|
44
|
+
- `docs/governance/SELF_HOSTED_RUNNER.md`
|
|
45
|
+
- `docs/governance/TODO.md`
|
|
46
|
+
|
|
47
|
+
## 🎯 安装方式
|
|
48
|
+
|
|
49
|
+
### 标准安装(推荐)✅
|
|
50
|
+
|
|
51
|
+
日常应用开发,包含核心功能 + CLI + Web UI + RAG/LLM operators
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
pip install isage
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
**包含组件**:
|
|
58
|
+
|
|
59
|
+
- **L1-L4**: 核心运行时、算法库、领域算子
|
|
60
|
+
- **L5**: CLI 工具 (`sage` 命令) + 开发工具
|
|
61
|
+
|
|
62
|
+
**独立仓库** (不在 SAGE 核心架构中):
|
|
63
|
+
|
|
64
|
+
- sage-benchmark - 基准测试
|
|
65
|
+
- sage-examples - 应用示例
|
|
66
|
+
- sage-studio - Web UI
|
|
67
|
+
- sageLLM - LLM 推理引擎
|
|
68
|
+
- **科学计算库**: numpy, pandas, matplotlib, scipy, jupyter
|
|
69
|
+
|
|
70
|
+
**大小**: ~200MB | **适合**: 应用开发者、日常使用
|
|
71
|
+
|
|
72
|
+
______________________________________________________________________
|
|
73
|
+
|
|
74
|
+
### 其他安装选项
|
|
75
|
+
|
|
76
|
+
#### 核心运行时
|
|
77
|
+
|
|
78
|
+
仅用于运行已有 pipeline(生产环境、容器部署)
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
pip install isage[core]
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
**大小**: ~100MB | **适合**: 生产部署
|
|
85
|
+
|
|
86
|
+
#### 完整功能
|
|
87
|
+
|
|
88
|
+
包含示例应用(医疗、视频)和性能测试工具
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
pip install isage[full]
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
**大小**: ~300MB | **适合**: 学习示例、性能评估
|
|
95
|
+
|
|
96
|
+
#### 框架开发
|
|
97
|
+
|
|
98
|
+
修改 SAGE 框架源代码
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
pip install isage[dev]
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
**大小**: ~400MB | **适合**: 框架贡献者
|
|
105
|
+
|
|
106
|
+
## 📦 包含的组件
|
|
107
|
+
|
|
108
|
+
### 默认安装 (standard)
|
|
109
|
+
|
|
110
|
+
- **isage-common** (L1): 基础工具和公共模块
|
|
111
|
+
- **isage-platform** (L2): 平台服务(队列、存储)
|
|
112
|
+
- **isage-kernel** (L3): 核心运行时和任务执行引擎
|
|
113
|
+
- **isage-libs** (L3): 算法库和 Agent 框架
|
|
114
|
+
- **isage-middleware** (L4): RAG/LLM operators
|
|
115
|
+
- **isage-tools** (L5): CLI 工具 (`sage` 命令)
|
|
116
|
+
- **isage-cli** (L5): 生产 CLI 接口
|
|
117
|
+
|
|
118
|
+
### 额外组件 (独立仓库/PyPI 包)
|
|
119
|
+
|
|
120
|
+
- **isage-benchmark**: 性能基准测试工具 (独立仓库: sage-benchmark)
|
|
121
|
+
- **isagellm**: LLM 推理引擎 (独立仓库: sageLLM)
|
|
122
|
+
- **isage-edge**: 边缘聚合器 (独立仓库: sage-edge)
|
|
123
|
+
|
|
124
|
+
## 快速开始
|
|
125
|
+
|
|
126
|
+
### 安装
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
# 标准安装(推荐)
|
|
130
|
+
pip install isage
|
|
131
|
+
|
|
132
|
+
# 或从源码安装
|
|
133
|
+
git clone https://github.com/intellistream/SAGE.git
|
|
134
|
+
cd SAGE
|
|
135
|
+
pip install -e packages/sage
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
## 使用示例
|
|
139
|
+
|
|
140
|
+
```python
|
|
141
|
+
import sage
|
|
142
|
+
|
|
143
|
+
# 创建 SAGE 应用
|
|
144
|
+
app = sage.create_app()
|
|
145
|
+
|
|
146
|
+
|
|
147
|
+
# 定义数据流处理
|
|
148
|
+
@app.stream("user_events")
|
|
149
|
+
def process_events(event):
|
|
150
|
+
return {
|
|
151
|
+
"user_id": event["user_id"],
|
|
152
|
+
"processed_at": sage.now(),
|
|
153
|
+
"result": "processed",
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
|
|
157
|
+
# 启动应用
|
|
158
|
+
if __name__ == "__main__":
|
|
159
|
+
app.run()
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
## 命令行工具
|
|
163
|
+
|
|
164
|
+
安装后,你可以使用以下命令:
|
|
165
|
+
|
|
166
|
+
```bash
|
|
167
|
+
# 查看版本
|
|
168
|
+
sage --version
|
|
169
|
+
|
|
170
|
+
# 创建新项目
|
|
171
|
+
sage create my-project
|
|
172
|
+
|
|
173
|
+
# 启动服务
|
|
174
|
+
sage run
|
|
175
|
+
|
|
176
|
+
# 查看帮助
|
|
177
|
+
sage --help
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
## 文档
|
|
181
|
+
|
|
182
|
+
- [用户指南](https://intellistream.github.io/SAGE-Pub/)
|
|
183
|
+
- [API 文档](https://intellistream.github.io/SAGE-Pub/api/)
|
|
184
|
+
- [开发者指南](https://intellistream.github.io/SAGE-Pub/dev/)
|
|
185
|
+
|
|
186
|
+
## 许可证
|
|
187
|
+
|
|
188
|
+
MIT License
|
|
189
|
+
|
|
190
|
+
## 贡献
|
|
191
|
+
|
|
192
|
+
欢迎贡献代码!请查看我们的[贡献指南](CONTRIBUTING.md)。
|
|
193
|
+
|
|
194
|
+
## 支持
|
|
195
|
+
|
|
196
|
+
如果你遇到问题或有疑问,请:
|
|
197
|
+
|
|
198
|
+
1. 查看[文档](https://intellistream.github.io/SAGE-Pub/)
|
|
199
|
+
1. 搜索[已知问题](https://github.com/intellistream/SAGE/issues)
|
|
200
|
+
1. 创建[新问题](https://github.com/intellistream/SAGE/issues/new)
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = [
|
|
3
|
+
"setuptools>=64",
|
|
4
|
+
"wheel",
|
|
5
|
+
"packaging>=24.2",
|
|
6
|
+
]
|
|
7
|
+
build-backend = "setuptools.build_meta"
|
|
8
|
+
|
|
9
|
+
[project]
|
|
10
|
+
name = "isage"
|
|
11
|
+
dynamic = [
|
|
12
|
+
"version",
|
|
13
|
+
]
|
|
14
|
+
description = "SAGE - Streaming-Augmented Generative Execution"
|
|
15
|
+
readme = "README.md"
|
|
16
|
+
authors = [
|
|
17
|
+
{ name = "SAGE Team", email = "shuhao_zhang@hust.edu.cn" },
|
|
18
|
+
]
|
|
19
|
+
classifiers = [
|
|
20
|
+
"Development Status :: 4 - Beta",
|
|
21
|
+
"Intended Audience :: Developers",
|
|
22
|
+
"Topic :: Software Development :: Libraries :: Python Modules",
|
|
23
|
+
"Topic :: Scientific/Engineering :: Artificial Intelligence",
|
|
24
|
+
"Topic :: System :: Distributed Computing",
|
|
25
|
+
]
|
|
26
|
+
requires-python = "==3.11.*"
|
|
27
|
+
dependencies = [
|
|
28
|
+
"isage-common>=0.2.4.13",
|
|
29
|
+
"isagellm>=0.5.1.2",
|
|
30
|
+
"isage-platform>=0.1.0",
|
|
31
|
+
"isage-kernel>=0.2.4.14",
|
|
32
|
+
"isage-libs>=0.1.0",
|
|
33
|
+
"isage-middleware>=0.1.0",
|
|
34
|
+
"isage-flownet>=0.1.0", # Flownet runtime (replaces Ray for distributed scheduling)
|
|
35
|
+
"isage-cli>=0.2.4.13", # SAGE CLI (sage command)
|
|
36
|
+
]
|
|
37
|
+
|
|
38
|
+
license = "MIT"
|
|
39
|
+
|
|
40
|
+
[project.optional-dependencies]
|
|
41
|
+
dev = [
|
|
42
|
+
"isage-tools>=0.1.0",
|
|
43
|
+
"pytest>=7.4.0",
|
|
44
|
+
"pytest-cov>=4.0.0",
|
|
45
|
+
"pytest-asyncio>=0.21.0",
|
|
46
|
+
"ruff==0.14.6",
|
|
47
|
+
"mypy>=1.7.0",
|
|
48
|
+
"pre-commit>=3.5.0",
|
|
49
|
+
"isage-pypi-publisher>=0.2.0",
|
|
50
|
+
]
|
|
51
|
+
|
|
52
|
+
[project.urls]
|
|
53
|
+
Homepage = "https://github.com/intellistream/SAGE"
|
|
54
|
+
Documentation = "https://intellistream.github.io/SAGE-Pub/"
|
|
55
|
+
Repository = "https://github.com/intellistream/SAGE.git"
|
|
56
|
+
"Bug Tracker" = "https://github.com/intellistream/SAGE/issues"
|
|
57
|
+
|
|
58
|
+
[tool.setuptools.packages.find]
|
|
59
|
+
namespaces = true
|
|
60
|
+
where = [
|
|
61
|
+
"src",
|
|
62
|
+
]
|
|
63
|
+
|
|
64
|
+
[tool.setuptools.package-dir]
|
|
65
|
+
"" = "src"
|
|
66
|
+
|
|
67
|
+
[tool.setuptools.dynamic.version]
|
|
68
|
+
attr = "sage._version.__version__"
|
|
69
|
+
|
|
70
|
+
[tool.ruff]
|
|
71
|
+
extend = "../../tools/ruff.toml"
|
|
72
|
+
|
|
73
|
+
[tool.mypy]
|
|
74
|
+
cache_dir = "../../.sage/cache/mypy"
|
|
75
|
+
ignore_missing_imports = true
|
|
76
|
+
|
|
77
|
+
[tool.setuptools]
|
|
78
|
+
include-package-data = true
|
|
79
|
+
|
|
80
|
+
[tool.setuptools.package-data]
|
|
81
|
+
"*" = ["*.pyc", "*.pyo", "__pycache__/*", "*.so", "*.pyd", "*.dylib"]
|
isage-0.2.4.18/setup.cfg
ADDED
isage-0.2.4.18/setup.py
ADDED
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: isage
|
|
3
|
+
Version: 0.2.4.18
|
|
4
|
+
Summary: SAGE - Streaming-Augmented Generative Execution
|
|
5
|
+
Author-email: SAGE Team <shuhao_zhang@hust.edu.cn>
|
|
6
|
+
License-Expression: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/intellistream/SAGE
|
|
8
|
+
Project-URL: Documentation, https://intellistream.github.io/SAGE-Pub/
|
|
9
|
+
Project-URL: Repository, https://github.com/intellistream/SAGE.git
|
|
10
|
+
Project-URL: Bug Tracker, https://github.com/intellistream/SAGE/issues
|
|
11
|
+
Classifier: Development Status :: 4 - Beta
|
|
12
|
+
Classifier: Intended Audience :: Developers
|
|
13
|
+
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
14
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
15
|
+
Classifier: Topic :: System :: Distributed Computing
|
|
16
|
+
Requires-Python: ==3.11.*
|
|
17
|
+
Description-Content-Type: text/markdown
|
|
18
|
+
Requires-Dist: isage-common>=0.2.4.13
|
|
19
|
+
Requires-Dist: isagellm>=0.5.1.2
|
|
20
|
+
Requires-Dist: isage-platform>=0.1.0
|
|
21
|
+
Requires-Dist: isage-kernel>=0.2.4.14
|
|
22
|
+
Requires-Dist: isage-libs>=0.1.0
|
|
23
|
+
Requires-Dist: isage-middleware>=0.1.0
|
|
24
|
+
Requires-Dist: isage-flownet>=0.1.0
|
|
25
|
+
Requires-Dist: isage-cli>=0.2.4.13
|
|
26
|
+
Provides-Extra: dev
|
|
27
|
+
Requires-Dist: isage-tools>=0.1.0; extra == "dev"
|
|
28
|
+
Requires-Dist: pytest>=7.4.0; extra == "dev"
|
|
29
|
+
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
|
|
30
|
+
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
|
|
31
|
+
Requires-Dist: ruff==0.14.6; extra == "dev"
|
|
32
|
+
Requires-Dist: mypy>=1.7.0; extra == "dev"
|
|
33
|
+
Requires-Dist: pre-commit>=3.5.0; extra == "dev"
|
|
34
|
+
Requires-Dist: isage-pypi-publisher>=0.2.0; extra == "dev"
|
|
35
|
+
|
|
36
|
+
# SAGE - Streaming-Augmented Generative Execution
|
|
37
|
+
|
|
38
|
+
SAGE (Streaming-Augmented Generative Execution) 是一个强大的分布式流数据处理平台的 Meta 包。
|
|
39
|
+
|
|
40
|
+
## ⚠️ PEP 420 Namespace Package
|
|
41
|
+
|
|
42
|
+
**CRITICAL**: SAGE 使用 PEP 420 namespace packages 架构。
|
|
43
|
+
|
|
44
|
+
```python
|
|
45
|
+
# ❌ 错误:不能直接导入 sage 命名空间
|
|
46
|
+
import sage
|
|
47
|
+
|
|
48
|
+
# ✅ 正确:导入具体的子包
|
|
49
|
+
import sage.common
|
|
50
|
+
import sage.kernel
|
|
51
|
+
import sage.middleware
|
|
52
|
+
from sage.common.config import get_user_paths
|
|
53
|
+
|
|
54
|
+
# 注意: sage.llm 已移至独立仓库 isagellm
|
|
55
|
+
# pip install isagellm
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
**为什么不能直接 `import sage`?**
|
|
59
|
+
|
|
60
|
+
- SAGE 采用 PEP 420 原生命名空间(无 `__init__.py`)
|
|
61
|
+
- 允许多个独立 PyPI 包共享 `sage.*` 命名空间
|
|
62
|
+
- 防止"命名空间劫持"(首个安装包独占 `sage/`)
|
|
63
|
+
- 符合现代 Python 标准(Python 3.3+)
|
|
64
|
+
|
|
65
|
+
**相关**: #1388 多仓库拆分准备
|
|
66
|
+
|
|
67
|
+
## 简介
|
|
68
|
+
|
|
69
|
+
这是 SAGE 的主要元包,提供分层的安装选项以适应不同使用场景。
|
|
70
|
+
|
|
71
|
+
## 🧭 Governance / 团队协作制度
|
|
72
|
+
|
|
73
|
+
本包的团队安排、负责人制度、协作流程与质量门槛见:
|
|
74
|
+
|
|
75
|
+
- `docs/governance/TEAM.md`
|
|
76
|
+
- `docs/governance/MAINTAINERS.md`
|
|
77
|
+
- `docs/governance/DEVELOPER_GUIDE.md`
|
|
78
|
+
- `docs/governance/PR_CHECKLIST.md`
|
|
79
|
+
- `docs/governance/SELF_HOSTED_RUNNER.md`
|
|
80
|
+
- `docs/governance/TODO.md`
|
|
81
|
+
|
|
82
|
+
## 🎯 安装方式
|
|
83
|
+
|
|
84
|
+
### 标准安装(推荐)✅
|
|
85
|
+
|
|
86
|
+
日常应用开发,包含核心功能 + CLI + Web UI + RAG/LLM operators
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
pip install isage
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
**包含组件**:
|
|
93
|
+
|
|
94
|
+
- **L1-L4**: 核心运行时、算法库、领域算子
|
|
95
|
+
- **L5**: CLI 工具 (`sage` 命令) + 开发工具
|
|
96
|
+
|
|
97
|
+
**独立仓库** (不在 SAGE 核心架构中):
|
|
98
|
+
|
|
99
|
+
- sage-benchmark - 基准测试
|
|
100
|
+
- sage-examples - 应用示例
|
|
101
|
+
- sage-studio - Web UI
|
|
102
|
+
- sageLLM - LLM 推理引擎
|
|
103
|
+
- **科学计算库**: numpy, pandas, matplotlib, scipy, jupyter
|
|
104
|
+
|
|
105
|
+
**大小**: ~200MB | **适合**: 应用开发者、日常使用
|
|
106
|
+
|
|
107
|
+
______________________________________________________________________
|
|
108
|
+
|
|
109
|
+
### 其他安装选项
|
|
110
|
+
|
|
111
|
+
#### 核心运行时
|
|
112
|
+
|
|
113
|
+
仅用于运行已有 pipeline(生产环境、容器部署)
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
pip install isage[core]
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
**大小**: ~100MB | **适合**: 生产部署
|
|
120
|
+
|
|
121
|
+
#### 完整功能
|
|
122
|
+
|
|
123
|
+
包含示例应用(医疗、视频)和性能测试工具
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
pip install isage[full]
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
**大小**: ~300MB | **适合**: 学习示例、性能评估
|
|
130
|
+
|
|
131
|
+
#### 框架开发
|
|
132
|
+
|
|
133
|
+
修改 SAGE 框架源代码
|
|
134
|
+
|
|
135
|
+
```bash
|
|
136
|
+
pip install isage[dev]
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
**大小**: ~400MB | **适合**: 框架贡献者
|
|
140
|
+
|
|
141
|
+
## 📦 包含的组件
|
|
142
|
+
|
|
143
|
+
### 默认安装 (standard)
|
|
144
|
+
|
|
145
|
+
- **isage-common** (L1): 基础工具和公共模块
|
|
146
|
+
- **isage-platform** (L2): 平台服务(队列、存储)
|
|
147
|
+
- **isage-kernel** (L3): 核心运行时和任务执行引擎
|
|
148
|
+
- **isage-libs** (L3): 算法库和 Agent 框架
|
|
149
|
+
- **isage-middleware** (L4): RAG/LLM operators
|
|
150
|
+
- **isage-tools** (L5): CLI 工具 (`sage` 命令)
|
|
151
|
+
- **isage-cli** (L5): 生产 CLI 接口
|
|
152
|
+
|
|
153
|
+
### 额外组件 (独立仓库/PyPI 包)
|
|
154
|
+
|
|
155
|
+
- **isage-benchmark**: 性能基准测试工具 (独立仓库: sage-benchmark)
|
|
156
|
+
- **isagellm**: LLM 推理引擎 (独立仓库: sageLLM)
|
|
157
|
+
- **isage-edge**: 边缘聚合器 (独立仓库: sage-edge)
|
|
158
|
+
|
|
159
|
+
## 快速开始
|
|
160
|
+
|
|
161
|
+
### 安装
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
# 标准安装(推荐)
|
|
165
|
+
pip install isage
|
|
166
|
+
|
|
167
|
+
# 或从源码安装
|
|
168
|
+
git clone https://github.com/intellistream/SAGE.git
|
|
169
|
+
cd SAGE
|
|
170
|
+
pip install -e packages/sage
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
## 使用示例
|
|
174
|
+
|
|
175
|
+
```python
|
|
176
|
+
import sage
|
|
177
|
+
|
|
178
|
+
# 创建 SAGE 应用
|
|
179
|
+
app = sage.create_app()
|
|
180
|
+
|
|
181
|
+
|
|
182
|
+
# 定义数据流处理
|
|
183
|
+
@app.stream("user_events")
|
|
184
|
+
def process_events(event):
|
|
185
|
+
return {
|
|
186
|
+
"user_id": event["user_id"],
|
|
187
|
+
"processed_at": sage.now(),
|
|
188
|
+
"result": "processed",
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
|
|
192
|
+
# 启动应用
|
|
193
|
+
if __name__ == "__main__":
|
|
194
|
+
app.run()
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
## 命令行工具
|
|
198
|
+
|
|
199
|
+
安装后,你可以使用以下命令:
|
|
200
|
+
|
|
201
|
+
```bash
|
|
202
|
+
# 查看版本
|
|
203
|
+
sage --version
|
|
204
|
+
|
|
205
|
+
# 创建新项目
|
|
206
|
+
sage create my-project
|
|
207
|
+
|
|
208
|
+
# 启动服务
|
|
209
|
+
sage run
|
|
210
|
+
|
|
211
|
+
# 查看帮助
|
|
212
|
+
sage --help
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
## 文档
|
|
216
|
+
|
|
217
|
+
- [用户指南](https://intellistream.github.io/SAGE-Pub/)
|
|
218
|
+
- [API 文档](https://intellistream.github.io/SAGE-Pub/api/)
|
|
219
|
+
- [开发者指南](https://intellistream.github.io/SAGE-Pub/dev/)
|
|
220
|
+
|
|
221
|
+
## 许可证
|
|
222
|
+
|
|
223
|
+
MIT License
|
|
224
|
+
|
|
225
|
+
## 贡献
|
|
226
|
+
|
|
227
|
+
欢迎贡献代码!请查看我们的[贡献指南](CONTRIBUTING.md)。
|
|
228
|
+
|
|
229
|
+
## 支持
|
|
230
|
+
|
|
231
|
+
如果你遇到问题或有疑问,请:
|
|
232
|
+
|
|
233
|
+
1. 查看[文档](https://intellistream.github.io/SAGE-Pub/)
|
|
234
|
+
1. 搜索[已知问题](https://github.com/intellistream/SAGE/issues)
|
|
235
|
+
1. 创建[新问题](https://github.com/intellistream/SAGE/issues/new)
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
MANIFEST.in
|
|
2
|
+
README.md
|
|
3
|
+
pyproject.toml
|
|
4
|
+
setup.py
|
|
5
|
+
src/isage.egg-info/PKG-INFO
|
|
6
|
+
src/isage.egg-info/SOURCES.txt
|
|
7
|
+
src/isage.egg-info/dependency_links.txt
|
|
8
|
+
src/isage.egg-info/requires.txt
|
|
9
|
+
src/isage.egg-info/top_level.txt
|
|
10
|
+
src/sage/__init__.py
|
|
11
|
+
src/sage/__init__.pyc
|
|
12
|
+
src/sage/_version.py
|
|
13
|
+
src/sage/_version.pyc
|
|
14
|
+
src/sage/__pycache__/__init__.cpython-311.pyc
|
|
15
|
+
src/sage/__pycache__/_version.cpython-311.pyc
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
isage-common>=0.2.4.13
|
|
2
|
+
isagellm>=0.5.1.2
|
|
3
|
+
isage-platform>=0.1.0
|
|
4
|
+
isage-kernel>=0.2.4.14
|
|
5
|
+
isage-libs>=0.1.0
|
|
6
|
+
isage-middleware>=0.1.0
|
|
7
|
+
isage-flownet>=0.1.0
|
|
8
|
+
isage-cli>=0.2.4.13
|
|
9
|
+
|
|
10
|
+
[dev]
|
|
11
|
+
isage-tools>=0.1.0
|
|
12
|
+
pytest>=7.4.0
|
|
13
|
+
pytest-cov>=4.0.0
|
|
14
|
+
pytest-asyncio>=0.21.0
|
|
15
|
+
ruff==0.14.6
|
|
16
|
+
mypy>=1.7.0
|
|
17
|
+
pre-commit>=3.5.0
|
|
18
|
+
isage-pypi-publisher>=0.2.0
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
sage
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
"""SAGE - Streaming-Augmented Generative Execution.
|
|
2
|
+
|
|
3
|
+
Meta-package that re-exports the version string and keeps the ``sage``
|
|
4
|
+
namespace open for all sub-packages (sage-common, sage-platform, etc.).
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
from __future__ import annotations
|
|
8
|
+
|
|
9
|
+
# Preserve namespace-package semantics so sub-packages installed in other
|
|
10
|
+
# directories (sage-common, sage-platform, …) are still discoverable even
|
|
11
|
+
# though this file now turns `sage` into a regular package from the
|
|
12
|
+
# meta-package's perspective.
|
|
13
|
+
import pkgutil
|
|
14
|
+
|
|
15
|
+
__path__ = pkgutil.extend_path(__path__, __name__)
|
|
16
|
+
|
|
17
|
+
# Expose the canonical version so ``sage.__version__`` works.
|
|
18
|
+
from sage._version import __author__, __email__, __version__
|
|
19
|
+
|
|
20
|
+
__all__ = ["__version__", "__author__", "__email__"]
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|