Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
blank_issues_enabled: true
contact_links:
- name: 📚 Documentation
url: https://github.com/SAGE-Research/SAGE/tree/main/docs
url: https://github.com/RIDE-Lab/SAGE/tree/main/docs
about: Check the documentation for guides and API references
- name: 💬 Discussions
url: https://github.com/SAGE-Research/SAGE/discussions
url: https://github.com/RIDE-Lab/SAGE/discussions
about: Ask questions and discuss ideas with the community
- name: 🔒 Security Issues
url: https://github.com/SAGE-Research/SAGE/security/advisories/new
url: https://github.com/RIDE-Lab/SAGE/security/advisories/new
about: Report security vulnerabilities privately
2 changes: 1 addition & 1 deletion .github/workflows/cd-publish-meta.yml
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ jobs:
- name: Install tooling
run: |
pip install --upgrade pip build wheel twine
pip install "sagepypi @ git+https://github.com/SAGE-Research/sagepypi.git@main"
pip install "sagepypi @ git+https://github.com/RIDE-Lab/sagepypi.git@main"

- name: Determine target repository
id: repo
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/ci-build-test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -257,7 +257,7 @@ jobs:
echo "✅ 目录创建完成"

# Note: sage-studio has been moved to an independent repository
# (https://github.com/SAGE-Research/sage-studio)
# (https://github.com/RIDE-Lab/sage-studio)
# Frontend checks are no longer part of the main SAGE CI pipeline

- name: Run installation validation suite
Expand Down
3 changes: 2 additions & 1 deletion .pre-commit-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -230,6 +230,7 @@ repos:
"CONTRIBUTING.md"
"coverage.xml"
"DEVELOPER.md"
"GOVERNANCE.md"
"LICENSE"
"Makefile"
"manage.sh"
Expand Down Expand Up @@ -377,7 +378,7 @@ repos:
exclude: ^(\.secrets\.baseline|\.env\.template|\.github/workflows/|examples/config/.*\.yaml|tests/fixtures/|.*package-lock\.json$|.*\.ipynb$|docs/.*\.md$|examples/.*\.py$|.*\.html$|.*/benchmark_anns/|ThirdParty/|thirdparty/|.*/implementations/(SPTAG|faiss|DiskANN|diskann-ms|candy|puck|pybind11)/)

# SAGE Data Architecture Validation - REMOVED (sage-benchmark is now independent)
# See: https://github.com/SAGE-Research/sage-benchmark
# See: https://github.com/RIDE-Lab/sage-benchmark
- repo: local
hooks:
- id: copilot-instructions-sync-check
Expand Down
8 changes: 4 additions & 4 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ sage-dev quality check --all-files --readme

```bash
# 克隆仓库(若已 fork,请替换为你的 fork 地址)
git clone https://github.com/SAGE-Research/SAGE.git
git clone https://github.com/RIDE-Lab/SAGE.git
cd SAGE

# 切换默认分支并更新
Expand Down Expand Up @@ -111,7 +111,7 @@ git rebase origin/main # 有冲突时解决后: git add <files> && git rebase
./quickstart.sh --core --yes

# 运行测试(当前推荐方式)
# 注意:示例已迁移到独立仓库 https://github.com/SAGE-Research/sage-examples
# 注意:示例已迁移到独立仓库 https://github.com/RIDE-Lab/sage-examples
sage-dev project test --coverage

# 运行全部 pytest (如需要更广覆盖)
Expand Down Expand Up @@ -288,7 +288,7 @@ Reduce flakiness via timeout + category filtering.
```bash
./quickstart.sh --core --yes # 安装/环境相关改动
sage-dev project test --coverage # 核心功能测试
# 注意:示例已迁移到 https://github.com/SAGE-Research/sage-examples
# 注意:示例已迁移到 https://github.com/RIDE-Lab/sage-examples
```

1. **集成测试**
Expand Down Expand Up @@ -483,7 +483,7 @@ pre-commit run cross-repo-dedup-check --all-files
| 单个测试 | `pytest src/tests/test_cli_main.py -v` | 直接运行指定测试文件 |
| 版本查看 | `python -c "from sage._version import __version__; print(__version__)"` | 确认当前安装版本 |

**注意**: 示例和应用已迁移到独立仓库: <https://github.com/SAGE-Research/sage-examples>
**注意**: 示例和应用已迁移到独立仓库: <https://github.com/RIDE-Lab/sage-examples>

> 任何命令失败,请附上一行重现命令与终端输出前 50 行发至 Issue。

Expand Down
8 changes: 4 additions & 4 deletions DEVELOPER.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ ______________________________________________________________________

```bash
# Clone repository
git clone https://github.com/SAGE-Research/SAGE.git
git clone https://github.com/RIDE-Lab/SAGE.git
cd SAGE

# Use canonical branch
Expand Down Expand Up @@ -77,7 +77,7 @@ git checkout main
- `sage chat --ask "Hello, SAGE!"`
- `sage index ingest --source ./docs --index local-docs`

> 💡 **注意**: 用户文档已迁移到独立的 [SAGE-Docs](https://github.com/SAGE-Research/SAGE-Docs) 仓库。
> 💡 **注意**: 用户文档已迁移到独立的 [SAGE-Docs](https://github.com/RIDE-Lab/SAGE-Docs) 仓库。

### Runtime Parallelism Contract

Expand All @@ -95,7 +95,7 @@ git checkout main
1. Clone and switch to canonical branch

```bash
git clone https://github.com/SAGE-Research/SAGE.git && cd SAGE
git clone https://github.com/RIDE-Lab/SAGE.git && cd SAGE
git checkout main
```

Expand Down Expand Up @@ -763,7 +763,7 @@ We follow [Semantic Versioning](https://semver.org/):
## Getting Help

- **Documentation**: Check `docs/`, `README.md`, and `CONTRIBUTING.md`
- **Examples**: See [sage-examples](https://github.com/SAGE-Research/sage-examples) repository
- **Examples**: See [sage-examples](https://github.com/RIDE-Lab/sage-examples) repository
- **Issues**: Search existing issues or create new one
- **Community**: Join our
[Slack](https://join.slack.com/t/intellistream/shared_invite/zt-2qayp8bs7-v4F71ge0RkO_rn34hBDWQg)
Expand Down
52 changes: 52 additions & 0 deletions GOVERNANCE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# SAGE Governance and Stewardship

## Shared Product Identity

SAGE — **Streaming-Augmented Generative Execution** — is the shared flagship
product and technical vision of the IntelliStream research ecosystem. It applies
streaming-computing principles to LLM inference and agent execution.

SAGE is a product boundary, not a fifth research organization. Its public surface
integrates work across agent systems, evolving-data infrastructure, and model
execution while keeping each implementation boundary explicit.

## Core Stewardship

The SAGE core series is hosted under the `RIDE-Lab` GitHub namespace because RIDE
Lab is its principal engineering steward. RIDE Lab maintains the core framework,
agent-facing product surfaces, reviews, releases, and product documentation.

Namespace placement is an operational home, not a claim of exclusive academic or
product ownership. SAGE remains a shared ecosystem product.

## Technical Ownership Boundaries

- **IntelliStream** incubates early cross-layer research until its public
abstraction, maintainers, evaluation path, and durable home are clear.
- **RIDE Lab** owns agent-native research systems and stewards SAGE core,
orchestration, RAG, evaluation, studio, and application-facing integration.
- **DataSys** owns framework-neutral stream, graph, vector/index, evolving-data,
query, lifecycle, and data-system benchmark implementations.
- **vLLM-HUST** owns model execution, KV-cache mechanisms, decode scheduling,
compilation, kernels, hardware backends, and inference validation.

SAGE consumes DataSys capabilities and calls vLLM-HUST through documented
interfaces. Shared product language never transfers implementation ownership across
these boundaries.

## Decision and Contribution Model

- Decisions remain with the maintainers of the repository that owns the affected
implementation.
- Cross-boundary changes should define an interface or integration contract and be
reviewed by maintainers on both sides.
- SAGE product documentation should distinguish shared product vision, core
stewardship, and dependency ownership.
- Moving a repository between organizations requires a durable ownership change;
product integration alone is not sufficient.

## Applications

Applications such as [Sage Mate](https://github.com/RIDE-Lab/sage-mate) are built
with SAGE and use vLLM-HUST or another explicitly configured inference service for
model execution. Application placement does not alter SAGE's shared-product status.
36 changes: 23 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,25 @@

> A dataflow-native framework for modular, controllable, and transparent LLM-augmented reasoning.

[![Build & Test](https://github.com/SAGE-Research/SAGE/actions/workflows/ci-build-test.yml/badge.svg?branch=main)](https://github.com/SAGE-Research/SAGE/actions/workflows/ci-build-test.yml)
[![codecov](https://codecov.io/gh/SAGE-Research/SAGE/branch/main/graph/badge.svg)](https://codecov.io/gh/SAGE-Research/SAGE)
[![Build & Test](https://github.com/RIDE-Lab/SAGE/actions/workflows/ci-build-test.yml/badge.svg?branch=main)](https://github.com/RIDE-Lab/SAGE/actions/workflows/ci-build-test.yml)
[![codecov](https://codecov.io/gh/RIDE-Lab/SAGE/branch/main/graph/badge.svg)](https://codecov.io/gh/RIDE-Lab/SAGE)
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/Python-3.11%2B-blue.svg)](https://python.org)
[![PyPI version](https://badge.fury.io/py/isage.svg)](https://badge.fury.io/py/isage)
[![GitHub Issues](https://img.shields.io/github/issues/SAGE-Research/SAGE)](https://github.com/SAGE-Research/SAGE/issues)
[![GitHub Stars](https://img.shields.io/github/stars/SAGE-Research/SAGE?style=social)](https://github.com/SAGE-Research/SAGE/stargazers)
[![GitHub Issues](https://img.shields.io/github/issues/RIDE-Lab/SAGE)](https://github.com/RIDE-Lab/SAGE/issues)
[![GitHub Stars](https://img.shields.io/github/stars/RIDE-Lab/SAGE?style=social)](https://github.com/RIDE-Lab/SAGE/stargazers)

**SAGE** turns LLM reasoning workflows into explicit dataflow pipelines. It is designed for
streaming execution, transparent orchestration, controllable serving, and modular integration with
retrieval, memory, tool-use, and inference-engine backends.

SAGE is the shared flagship product and technical vision of the IntelliStream research ecosystem.
Its name captures that vision: **Streaming-Augmented Generative Execution** applies
streaming-computing principles—explicit dataflow, state, backpressure, and continuous execution—to
LLM inference and agent systems. RIDE Lab is the principal engineering steward of the core
repositories, while DataSys and vLLM-HUST retain ownership of their data-system and inference
boundaries. See [GOVERNANCE.md](./GOVERNANCE.md) for the stewardship contract.

## News

- **May 2026**: The SAGE paper was accepted to **ICML 2026**: *SAGE: A Dataflow-Native Framework for
Expand Down Expand Up @@ -108,15 +115,15 @@ env.submit(autostop=True)
### Try it yourself

```bash
git clone https://github.com/SAGE-Research/SAGE.git && cd SAGE
git clone https://github.com/RIDE-Lab/SAGE.git && cd SAGE
git checkout main
./quickstart.sh --dev --yes

# Verify the in-tree core surface
sage verify

# Explore tutorials from the separate learning repo
git clone https://github.com/SAGE-Research/sage-tutorials.git
git clone https://github.com/RIDE-Lab/sage-tutorials.git
python sage-tutorials/L1-common/hello_world.py
```

Expand Down Expand Up @@ -178,7 +185,7 @@ capabilities), forbidden directions, and boundary refactor review checklist
### Quickstart (Recommended)

```bash
git clone https://github.com/SAGE-Research/SAGE.git && cd SAGE
git clone https://github.com/RIDE-Lab/SAGE.git && cd SAGE
./quickstart.sh --dev --yes
# or
./quickstart.sh --standard --yes
Expand Down Expand Up @@ -289,7 +296,7 @@ Tutorials live in the separate `sage-tutorials` repository so that learning mate
without drifting the main package contract.

```bash
git clone https://github.com/SAGE-Research/sage-tutorials.git
git clone https://github.com/RIDE-Lab/sage-tutorials.git
cd sage-tutorials
python L1-common/hello_world.py
```
Expand All @@ -304,7 +311,7 @@ README.
- **Architecture**: [https://sage.org.ai/architecture/](https://sage.org.ai/architecture/)
- **Developer guide**: [DEVELOPER.md](./DEVELOPER.md)
- **Contribution guide**: [CONTRIBUTING.md](./CONTRIBUTING.md)
- **Tutorials**: [SAGE-Research/sage-tutorials](https://github.com/SAGE-Research/sage-tutorials)
- **Tutorials**: [RIDE-Lab/sage-tutorials](https://github.com/RIDE-Lab/sage-tutorials)

## Contributing

Expand Down Expand Up @@ -386,10 +393,13 @@ capability boundary or migration purpose.

## Community

Use [GitHub Issues](https://github.com/SAGE-Research/SAGE/issues) for bugs and feature requests. For
broader design discussions, use
[GitHub Discussions](https://github.com/SAGE-Research/SAGE/discussions) when enabled for the
repository.
Use [GitHub Issues](https://github.com/RIDE-Lab/SAGE/issues) for bugs and feature requests. For
broader design discussions, use [GitHub Discussions](https://github.com/RIDE-Lab/SAGE/discussions)
when enabled for the repository.

Repository placement under `RIDE-Lab` identifies the core engineering steward; it does not make SAGE
an exclusive product of one research organization. Cross-organization contributions follow the
ownership boundaries documented in [GOVERNANCE.md](./GOVERNANCE.md).

## License

Expand Down
2 changes: 1 addition & 1 deletion docs/dependency-audit-gate.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ The repo no longer treats the retired split-package layout as a set of direct de
- Rationale: in-tree `sage-dev` developer workflow and validation.

Release automation installs `sagepypi` directly from
`https://github.com/SAGE-Research/sagepypi`; it is not a runtime, test, or
`https://github.com/RIDE-Lab/sagepypi`; it is not a runtime, test, or
general development dependency and is not published as a PyPI distribution.

## How To Update
Expand Down
2 changes: 1 addition & 1 deletion hooks/pre-push
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,7 @@ schedule_publish() {

if ! resolve_publisher_cmd; then
echo -e "${YELLOW}⚠ sagepypi not found, skipping auto-publish${NC}"
echo -e "${DIM} Install: python -m pip install \"sagepypi @ git+https://github.com/SAGE-Research/sagepypi.git@main\"${NC}"
echo -e "${DIM} Install: python -m pip install \"sagepypi @ git+https://github.com/RIDE-Lab/sagepypi.git@main\"${NC}"
return
fi

Expand Down
4 changes: 2 additions & 2 deletions pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -89,8 +89,8 @@ dev = [
[project.urls]
Homepage = "https://sage.org.ai/"
Documentation = "https://sage.org.ai/getting-started/"
Repository = "https://github.com/SAGE-Research/SAGE.git"
"Bug Tracker" = "https://github.com/SAGE-Research/SAGE/issues"
Repository = "https://github.com/RIDE-Lab/SAGE.git"
"Bug Tracker" = "https://github.com/RIDE-Lab/SAGE/issues"

[tool.setuptools.packages.find]
namespaces = true
Expand Down
14 changes: 7 additions & 7 deletions quickstart.sh
Original file line number Diff line number Diff line change
Expand Up @@ -272,10 +272,10 @@ _init_sage_workspace() {

if [ ${#SAGE_REPOS[@]} -eq 0 ]; then
SAGE_REPOS=(
"https://github.com/SAGE-Research/SAGE-Docs.git"
"https://github.com/SAGE-Research/sage-benchmark.git"
"https://github.com/SAGE-Research/sage-examples.git"
"https://github.com/SAGE-Research/sage-tutorials.git"
"https://github.com/RIDE-Lab/SAGE-Docs.git"
"https://github.com/RIDE-Lab/sage-benchmark.git"
"https://github.com/RIDE-Lab/sage-examples.git"
"https://github.com/RIDE-Lab/sage-tutorials.git"
)
fi

Expand Down Expand Up @@ -303,8 +303,8 @@ _init_sage_workspace() {

# ── 主 SAGE meta 仓库(当前仓库)─────────────────────────────────────────
if [ ! -d "$workspace_dir/SAGE/.git" ]; then
echo -e " ${CYAN}⬇${NC} clone SAGE-Research/SAGE (meta)..."
git clone "https://github.com/SAGE-Research/SAGE.git" "$workspace_dir/SAGE" --depth 1 2>&1 | tail -1 && ((ok++)) || ((fail++))
echo -e " ${CYAN}⬇${NC} clone RIDE-Lab/SAGE (meta)..."
git clone "https://github.com/RIDE-Lab/SAGE.git" "$workspace_dir/SAGE" --depth 1 2>&1 | tail -1 && ((ok++)) || ((fail++))
else
echo -e " ${YELLOW}↻${NC} SAGE — 已存在,跳过"
((skip++))
Expand Down Expand Up @@ -794,7 +794,7 @@ main() {
if [ "${SAGE_SET_SKIP_SMUDGE:-0}" = 1 ]; then
echo -e "${DIM}提示: 已跳过 Git LFS 大文件的自动下载,以缩短初始化时间。${NC}"
echo -e "${DIM}如需使用 LibAMM 基准数据,请在独立 benchmark 仓库执行数据初始化脚本。${NC}"
echo -e " ${DIM}参考: https://github.com/SAGE-Research/sage-benchmark${NC}"
echo -e " ${DIM}参考: https://github.com/RIDE-Lab/sage-benchmark${NC}"
fi
else
echo ""
Expand Down
2 changes: 1 addition & 1 deletion tools/install/checks/install_verification.sh
Original file line number Diff line number Diff line change
Expand Up @@ -347,7 +347,7 @@ verify_sage_imports() {
# - sageLLM: 独立 PyPI 包 isagellm (pip install isagellm)
# - sage-examples (原 sage.apps): 已迁移到 sage-examples 仓库
# - sage.benchmark: 独立 PyPI 包 isage-benchmark (pip install isage-benchmark)
# - sage.studio: 独立仓库 https://github.com/SAGE-Research/sage-studio
# - sage.studio: 独立仓库 https://github.com/RIDE-Lab/sage-studio
# - sage.edge: 已回归主仓产品面;根包导入应始终可用,FastAPI 运行依赖由 extras 提供
local sage_packages=(
"sage.foundation" # Core: in-tree foundation
Expand Down
2 changes: 1 addition & 1 deletion tools/install/fixes/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@ SAGE 提供了自动诊断和修复工具,可以帮您解决大部分环境问
./quickstart.sh --doctor --fix

💡 了解更多:
https://github.com/SAGE-Research/SAGE/wiki/Installation-Troubleshooting
https://github.com/RIDE-Lab/SAGE/wiki/Installation-Troubleshooting
```

## 架构设计
Expand Down
6 changes: 3 additions & 3 deletions tools/install/fixes/friendly_error_handler.sh
Original file line number Diff line number Diff line change
Expand Up @@ -153,9 +153,9 @@ show_friendly_error() {
fi

echo -e "\n${BLUE}${BOLD}📚 获取更多帮助:${NC}"
echo -e " • 安装故障排除指南:${DIM}https://github.com/SAGE-Research/SAGE/wiki/Troubleshooting${NC}"
echo -e " • 环境配置最佳实践:${DIM}https://github.com/SAGE-Research/SAGE/wiki/Environment-Setup${NC}"
echo -e " • 提交问题报告:${DIM}https://github.com/SAGE-Research/SAGE/issues${NC}"
echo -e " • 安装故障排除指南:${DIM}https://github.com/RIDE-Lab/SAGE/wiki/Troubleshooting${NC}"
echo -e " • 环境配置最佳实践:${DIM}https://github.com/RIDE-Lab/SAGE/wiki/Environment-Setup${NC}"
echo -e " • 提交问题报告:${DIM}https://github.com/RIDE-Lab/SAGE/issues${NC}"

echo -e "\n${BLUE}═══════════════════════════════════════════════════════════════${NC}"

Expand Down
2 changes: 1 addition & 1 deletion tools/install/fixes/numpy_fix.sh
Original file line number Diff line number Diff line change
Expand Up @@ -245,7 +245,7 @@ show_numpy_error_help() {
echo -e " ${DIM}./quickstart.sh${NC}\n"

echo -e "${BLUE}💡 了解更多:${NC}"
echo -e " ${DIM}https://github.com/SAGE-Research/SAGE/wiki/Installation-Troubleshooting${NC}\n"
echo -e " ${DIM}https://github.com/RIDE-Lab/SAGE/wiki/Installation-Troubleshooting${NC}\n"

log_info "已显示numpy错误帮助信息" "NumpyFix"
}
6 changes: 3 additions & 3 deletions tools/install/installers/clone_satellite_repos.sh
Original file line number Diff line number Diff line change
Expand Up @@ -57,9 +57,9 @@ for index, item in enumerate(repositories):
raise SystemExit(
f"invalid satellite repository manifest: {name} clone_by_default must be boolean"
)
if not full_name.startswith("SAGE-Research/") or full_name.count("/") != 1:
if not full_name.startswith("RIDE-Lab/") or full_name.count("/") != 1:
raise SystemExit(
f"invalid satellite repository manifest: {name} must belong to SAGE-Research"
f"invalid satellite repository manifest: {name} must belong to RIDE-Lab"
)
if full_name.rsplit("/", 1)[1] != name:
raise SystemExit(
Expand Down Expand Up @@ -250,7 +250,7 @@ interactive_clone_repos() {
echo ""
echo -e "${YELLOW}💡 提示:${NC}"
echo -e "${DIM} 如果不克隆,可以稍后手动克隆:${NC}"
echo -e "${DIM} git clone https://github.com/SAGE-Research/sage-examples.git${NC}"
echo -e "${DIM} git clone https://github.com/RIDE-Lab/sage-examples.git${NC}"
echo ""

read -p "是否现在克隆附属仓库?[y/N]: " -r response
Expand Down
Loading
Loading