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.
@@ -0,0 +1,7 @@
1
+ # Include compiled files and binary extensions
2
+ recursive-include src *.pyc
3
+ recursive-include src *.pyo
4
+ recursive-include src __pycache__/*
5
+ recursive-include src *.so
6
+ recursive-include src *.pyd
7
+ recursive-include src *.dylib
@@ -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,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"]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,9 @@
1
+
2
+ from setuptools import setup
3
+
4
+ setup(
5
+ include_package_data=True,
6
+ package_data={
7
+ "": ["*.pyc", "*.pyo", "__pycache__/*", "*.so", "*.pyd", "*.dylib"],
8
+ },
9
+ )
@@ -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,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
@@ -0,0 +1,6 @@
1
+ """Version information for sage package."""
2
+
3
+ # 独立硬编码版本
4
+ __version__ = "0.2.4.18"
5
+ __author__ = "IntelliStream Team"
6
+ __email__ = "shuhao_zhang@hust.edu.cn"
Binary file