isage-cli 0.2.4.12__py2.py3-none-any.whl

isage_cli-0.2.4.12.dist-info/METADATA

@@ -0,0 +1,295 @@
+Metadata-Version: 2.4
+Name: isage-cli
+Version: 0.2.4.12
+Summary: SAGE Command Line Interface - Unified CLI for SAGE platform
+Author-email: IntelliStream Team <shuhao_zhang@hust.edu.cn>
+License: MIT
+Project-URL: Homepage, https://github.com/intellistream/SAGE
+Project-URL: Documentation, https://intellistream.github.io/SAGE
+Project-URL: Repository, https://github.com/intellistream/SAGE
+Project-URL: Issues, https://github.com/intellistream/SAGE/issues
+Keywords: sage,cli,command-line,streaming,ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: typer<1.0.0,>=0.15.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-dotenv<2.0.0,>=1.1.0
+Requires-Dist: requests<3.0.0,>=2.32.0
+Requires-Dist: httpx<1.0.0,>=0.28.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: tabulate<1.0.0,>=0.9.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: ruff==0.14.6; extra == "dev"
+Requires-Dist: isage-pypi-publisher>=0.2.0; extra == "dev"
+
+# SAGE CLI
+
+> **Unified Command Line Interface for SAGE Platform**
+
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](../../LICENSE)
+
+SAGE CLI (`sage-cli`) is the unified command-line interface for the SAGE (Streaming-Augmented
+Generative Execution) platform. It provides a comprehensive set of commands for managing clusters,
+deploying applications, and developing with SAGE.
+
+## 🧭 Governance / 团队协作制度
+
+- `docs/governance/TEAM.md`
+- `docs/governance/MAINTAINERS.md`
+- `docs/governance/DEVELOPER_GUIDE.md`
+- `docs/governance/PR_CHECKLIST.md`
+- `docs/governance/SELF_HOSTED_RUNNER.md`
+- `docs/governance/TODO.md`
+
+## 📋 Overview
+
+**SAGE CLI** is the unified command-line interface for SAGE platform, providing commands for:
+
+- **Cluster Management**: Start/stop Flownet-based runtime clusters, manage head/worker nodes
+- **LLM Services**: Launch and manage LLM inference services
+- **Development**: Tools for testing, quality checks, and project management
+- **Monitoring**: System diagnostics and status checks
+
+## ✨ Features
+
+- **Unified Interface**: Single `sage` command for all platform operations
+- **Cluster Orchestration**: Full Flownet runtime lifecycle management
+- **LLM Integration**: Start LLM services with automatic model loading
+- **Interactive Chat**: Built-in chat interface for testing
+- **Development Tools**: Via separate `sage-dev` command from sage-tools package
+
+## 🚀 Installation
+
+```bash
+# From source
+cd packages/sage-cli
+pip install -e .
+
+# Or install from PyPI (when published)
+pip install sage-cli
+```
+
+## 📋 Command Structure
+
+SAGE CLI organizes commands into two main categories:
+
+### Platform Commands
+
+Manage SAGE infrastructure and system components:
+
+- `sage cluster` - Flownet runtime cluster management
+- `sage head` - Head node management
+- `sage worker` - Worker node management
+- `sage job` - Job management
+- `sage jobmanager` - JobManager service
+- `sage config` - Configuration management
+- `sage doctor` - System diagnostics
+- `sage version` - Version information
+- `sage extensions` - C++ extension management
+
+### Application Commands
+
+Application-level functionality:
+
+- `sage llm` - LLM service management
+- `sage chat` - Interactive chat interface
+- `sage embedding` - Embedding service management
+- `sage pipeline` - Pipeline builder
+- `sage studio` - Visual pipeline editor
+
+### Development Commands
+
+**Note:** Development commands are provided by the `sage-tools` package separately via the
+`sage-dev` command.
+
+To use development tools:
+
+```bash
+# Install sage-tools (if not already installed)
+pip install sage-tools
+
+# Use sage-dev command
+sage-dev quality check
+sage-dev project test
+sage-dev maintain doctor
+```
+
+Development command groups include:
+
+- `sage-dev quality` - Code quality checks
+- `sage-dev project` - Project management
+- `sage-dev maintain` - Maintenance tools
+- `sage-dev package` - Package management
+- `sage-dev resource` - Resource management
+- `sage-dev github` - GitHub utilities
+
+## 📖 Quick Start
+
+### Basic Commands
+
+```bash
+# Check system status
+sage doctor
+
+# View version
+sage version
+
+# Get help
+sage --help
+sage <command> --help
+```
+
+### Cluster Management
+
+```bash
+# Start a cluster
+sage cluster start
+
+# View cluster status
+sage cluster status
+
+# Stop cluster
+sage cluster stop
+```
+
+### LLM Service
+
+```bash
+# Start LLM service
+sage llm start --model Qwen/Qwen2.5-7B-Instruct
+
+# Check status
+sage llm status
+
+# Interactive chat
+sage chat
+```
+
+### Development Tools
+
+For development commands, install `sage-tools`:
+
+```bash
+pip install sage-tools
+
+# Run development checks
+sage-dev quality check
+
+# Run tests
+sage-dev project test
+```
+
+## � Configuration
+
+SAGE CLI reads configuration from:
+
+- `~/.sage/config.yaml` - User configuration
+- `./config/config.yaml` - Project configuration
+- Environment variables: `SAGE_*`
+
+```yaml
+# config.yaml example
+cluster:
+  head_node: localhost
+  workers: 4
+
+llm:
+  model: Qwen/Qwen2.5-7B-Instruct
+  port: 8001
+```
+
+## 📦 Package Structure
+
+```
+sage-cli/
+├── src/
+│   └── sage/
+│       └── cli/
+│           ├── commands/      # Command implementations
+│           ├── cluster/       # Cluster management
+│           └── llm/           # LLM service commands
+├── tests/
+├── pyproject.toml
+└── README.md
+```
+
+## 🧪 Testing
+
+```bash
+# Run CLI tests
+pytest packages/sage-cli/tests/
+
+# Test specific command
+sage --help
+sage cluster --help
+
+# Run integration tests
+sage-dev project test --package sage-cli
+```
+
+## �📚 Documentation
+
+For detailed documentation, see:
+
+- [SAGE Documentation](https://intellistream.github.io/SAGE)
+- [Project Changelog](../../CHANGELOG.md)
+
+## 🏗️ Architecture
+
+SAGE CLI is part of the L5 (Interface Layer) in the SAGE architecture:
+
+```
+L1: sage-common          (Foundation)
+L2: sage-platform        (Platform Core)
+L3: sage-kernel, sage-libs
+L4: sage-middleware
+L5: sage-cli, sage-tools
+    ├── sage-cli: Production CLI via `sage` command
+    └── sage-tools: Development tools via `sage-dev` command
+```
+
+**Independent Repositories:**
+
+- sage-benchmark: Benchmark suites
+- sage-examples: Applications and tutorials
+- sage-studio: Visual interface
+- sageLLM: LLM inference engine
+
+**Command Separation:**
+
+- **sage** (from sage-cli): User-facing production commands
+
+  - Platform: cluster, head, worker, job, jobmanager, config, doctor, version, extensions
+  - Apps: llm, chat, embedding, pipeline
+
+- **sage-dev** (from sage-tools): Developer-only commands
+
+  - quality, project, maintain, package, resource, github
+
+Both packages are independent and can be installed separately.
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](../../CONTRIBUTING.md) for guidelines.
+
+## 📄 License
+
+Apache License 2.0 - see [LICENSE](../../LICENSE) for details.
+
+## 🔗 Related Packages
+
+- `sage-tools` - Development tools and `sage-dev` commands
+- `sage-platform` - SAGE platform core
+- `sage-apps` - SAGE applications
+- `sage-studio` - Visual pipeline editor

isage_cli-0.2.4.12.dist-info/RECORD

@@ -0,0 +1,58 @@
+sage/cli/__init__.py,sha256=bo7KxexewLNQP2YcoXpvXtOi3Kkoo-OVVKwVAbt-SjQ,497
+sage/cli/_version.py,sha256=QudkwDIVkRCUOizJ5yYAh29sLpTMmqS5l_FuSO6QEPk,139
+sage/cli/main.py,sha256=ur2lqg6_47jJ3k67jis9I1TM2K8aVvLTtqsBpVMDFbA,8996
+sage/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sage/cli/commands/demo.py,sha256=ZldScyTQCCvVyAC0vXOQa5pJ3cNkY5RP3gL1jcSR1g8,9439
+sage/cli/commands/apps/__init__.py,sha256=1K2eJIJDAPjI0x6UjS3-D2pSkoZPJY08gCSZMUypSlg,1781
+sage/cli/commands/apps/chat.py,sha256=_kV5_vMcy_2qMRuIf2Wg9elUIYEN-kOisfNz_JgqKoI,78108
+sage/cli/commands/apps/embedding.py,sha256=MOfpCy7kUbK0WyfAB6Va6b1H42GMPRUDRYFE4yr2osM,12015
+sage/cli/commands/apps/gateway.py,sha256=GaqHXiSnzeRscJOgj-RrneM_-noFN3BnXi4PqQW4AFA,14301
+sage/cli/commands/apps/inference.py,sha256=cVMd6uyVrfAdrPTQSz_rbwfhHwKrAF9r5rRCTsixXWc,21620
+sage/cli/commands/apps/llm.py,sha256=D2T4fSBT0ifN8T8UzduXm-nnoH53CInpsgj3obK6FqI,6505
+sage/cli/commands/apps/pipeline.py,sha256=pNwXlhl7LeCXYEa-NtJ3feB-5mIPRqXd1HDlNmPabXM,59894
+sage/cli/commands/apps/pipeline_domain.py,sha256=zivBsd7f2aLinNHFxwRE5R99fDZt-vY3dHn4sbIkRVk,8257
+sage/cli/commands/apps/pipeline_embedding.py,sha256=YFmlBk5FU_4pOKpytiDDo8qD8S5tw99-59o5COyah5Y,18651
+sage/cli/commands/apps/pipeline_knowledge.py,sha256=NDNCppNpfMEhabQXqovW8lB-AWni9T4yg0wucnpGqHQ,13848
+sage/cli/commands/platform/__init__.py,sha256=pMptBNWXT_duZwFLlXmu49JpOQhJYc6sFZrLUOUwajw,2889
+sage/cli/commands/platform/cluster.py,sha256=XoRC2CTpD142ervDQiXHzUyXsZogUKmAHsmsg0kgjM8,11583
+sage/cli/commands/platform/config.py,sha256=gqv7l6os-f9D7x7CJbnFaKYV8L37lGXQuPshuU-Acz0,2667
+sage/cli/commands/platform/docs.py,sha256=Wo7eDpzY7VIAX-pcHsKa2ZLiErdp8LrU1Wd2BkZ7TN0,7272
+sage/cli/commands/platform/doctor.py,sha256=zwATcQsEUcOjJu1C5mwqWwYOSoCeowEUdzHiXA4Wh6A,1832
+sage/cli/commands/platform/env.py,sha256=R28wFrOIgcy-4OBcinCRNxyGiCPGdv4q3VHh_Q-OqEU,5137
+sage/cli/commands/platform/extensions.py,sha256=awq2qurR5qNqquwmIhxMyeq7fGmMngT1jC_-Phyl-eM,31534
+sage/cli/commands/platform/head.py,sha256=PKsCe5mz0kqe2DDTcbWkiPdEwCef7o2qhO7Il0IvfZk,14682
+sage/cli/commands/platform/job.py,sha256=AeyCMAWtZoL52Gb9i9jBMUwufQHAPUwwcXCgyAkrI0o,21559
+sage/cli/commands/platform/jobmanager.py,sha256=zSOck8ZWcZptX6ey89zh72vV5kOFeX2zU-6rCbahkx4,24874
+sage/cli/commands/platform/llm_config.py,sha256=zjcNHHE6S2R02lTDvfXzHiAmIkA5xc9bDGe29Vnj3iI,6858
+sage/cli/commands/platform/logs.py,sha256=ORIXwgGLf1DIoqjk_I57rSE6gdzU0hFOgfLgD_z0zLs,8881
+sage/cli/commands/platform/runtime.py,sha256=pnT3ds3tG1Z0HTC4-PnvFBJPCb0Q92axCp2mtdcLgb8,9776
+sage/cli/commands/platform/runtime_checker.py,sha256=RfqnLzD01E1BVohXYNbxq4_Me72hhMtoazs1Nei5VUI,4204
+sage/cli/commands/platform/ssh_setup.py,sha256=pPeI92i-eXBKXP68SvvgBg1ycJFdVaPWstAgd_w78gU,9052
+sage/cli/commands/platform/version.py,sha256=qabquT956A5VtYAB1INrUwWfQhfdYaamnfGDmD9vy1Q,1843
+sage/cli/commands/platform/worker.py,sha256=OOiualcwflZxyzKJ-mkDJZRCwXc-Ox4f8EQFYcR3Qiw,18190
+sage/cli/core/__init__.py,sha256=Zkrk5Kic3MFD6LaYarKaToCKBoxHRUTXd0Sz6pgZRMk,406
+sage/cli/core/base.py,sha256=aP6jwDXhnd3Ho_ybWiqHm6ev5a-dXgWrXyeD2TlUEWY,12526
+sage/cli/core/config.py,sha256=Cls55jf4y74of79KJkJiXbC8CAnjQdgqwVLmNedT65w,10054
+sage/cli/core/config_refactored.py,sha256=cuYp2n0hLaXftkZTlfhVt1Rnqjmetneh0rPp2rxQtdg,8660
+sage/cli/core/exceptions.py,sha256=7gY4BvVNVyRsq9a1PTf1S5cGLW0Pihh7BRLAYriGRkc,1491
+sage/cli/core/output.py,sha256=3moyyeMiQvODNnpOv6VQtBkswmWmpCF0vBXDrIH0CX0,8206
+sage/cli/core/refactor_example.py,sha256=EBN6SqWGawhAr7T7d_PwEDRJ9lMchNXbhgXPqj1mFUk,8415
+sage/cli/core/ssh.py,sha256=-UUz8pJF9yewtS67l9EpKG-7f7tiwm-ChxUT-iRzRAY,11514
+sage/cli/core/utils.py,sha256=WulPrzXZPEBVgKTcwEZQrfPf8SRNB1walTZODHBnLoI,11143
+sage/cli/core/validation.py,sha256=uSEpe7sd3R_1t7v4XDnM3wgALrhLbZxrSNivwTNOT7Y,9906
+sage/cli/management/__init__.py,sha256=SGBGkAnrV4kstcpUXtEP5UxmtaHc00AhcDkH10hfZA4,304
+sage/cli/management/config_manager.py,sha256=xUiv6N2PNO3EKg1J69YyxFdz51GYDYXhZjYMCSftGUs,11451
+sage/cli/management/deployment_manager.py,sha256=87FjBnlDfZfDc28bww5GQolQuVqzxO6CHonKK4Jq_PU,31405
+sage/cli/templates/__init__.py,sha256=_eZAevfgv68fwiB9g3VgstXAyTCgrfnMvqvJD8i9q6s,431
+sage/cli/templates/catalog.py,sha256=2yV3xsu0fphDFetElByZy93NRWhdLW6hVvvjeO5Pe3U,18812
+sage/cli/templates/pipeline_blueprints.py,sha256=aIUQh-gNPXU9jztI_-PZK4QeLTZ4YeetFIuzwwlBcG0,39361
+sage/cli/utils/__init__.py,sha256=RQAnoP6uiDzcHt2eW0-bb6g8NGiOxQEH6Gne49NsLm4,329
+sage/cli/utils/dev_check.py,sha256=G3KY5mTBRfUZj9pbs4waPtFGZm1QjPMuhv-_pgTU1sA,3873
+sage/cli/utils/diagnostics.py,sha256=Eccq_7E2zpcfwMcer1om4loRolzbsiyZ1dTuHdZiQ8A,17284
+sage/cli/utils/env.py,sha256=httNtm4RjYG88SffH4cW_gg_HInqMcrvA0r6NLURAuE,5657
+sage/cli/utils/llm_detection.py,sha256=Im3caKRKu9U9qL8MGM-izkeFj7ICBWAc32JN4tb44kY,5540
+isage_cli-0.2.4.12.dist-info/METADATA,sha256=D49EsgDsdB7ymfuhR4TwxqI1UqvWC8Mc0h45bisLlGM,7575
+isage_cli-0.2.4.12.dist-info/WHEEL,sha256=Mk1ST5gDzEO5il5kYREiBnzzM469m5sI8ESPl7TRhJY,110
+isage_cli-0.2.4.12.dist-info/entry_points.txt,sha256=s77M4e4PHBSG58s7WdArt8mtBeC579CmWrcKYKVFUJ0,43
+isage_cli-0.2.4.12.dist-info/top_level.txt,sha256=hibFyzQHiLOMK68qL1OWsNKaXOmSXqZjeLTBem6Yy7I,5
+isage_cli-0.2.4.12.dist-info/RECORD,,

isage_cli-0.2.4.12.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+

isage_cli-0.2.4.12.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sage = sage.cli.main:app

isage_cli-0.2.4.12.dist-info/top_level.txt

@@ -0,0 +1 @@
+sage

sage/cli/__init__.py

@@ -0,0 +1,22 @@
+"""SAGE CLI - Command Line Interface (L5)
+
+Layer: L5 (Interface Layer)
+
+Unified command-line interface for SAGE platform operations:
+- App management (run, stop, status)
+- LLM service control (start, stop, status)
+- Cluster management
+- Development tools
+
+Architecture Rules:
+- ✅ Can import from: L1-L4 (all lower layers)
+- ❌ Must NOT be imported by: other packages (top layer, no upward dependencies)
+"""
+
+from ._version import __version__
+
+__layer__ = "L5"
+
+__all__ = [
+    "__version__",
+]

sage/cli/_version.py

@@ -0,0 +1,5 @@
+"""Version information for sage-cli."""
+
+__version__ = "0.2.4.12"
+__author__ = "IntelliStream Team"
+__email__ = "shuhao_zhang@hust.edu.cn"

sage/cli/commands/apps/__init__.py

@@ -0,0 +1,68 @@
+"""
+SAGE Application Commands
+
+应用层命令组，包括：
+- llm: LLM服务管理
+- chat: 编程助手
+- embedding: Embedding管理
+- pipeline: Pipeline构建器
+- inference: 统一推理服务管理
+- gateway: API网关服务
+
+Note: studio和edge已独立为单独的仓库/包，不再包含在CLI中
+"""
+
+from rich.console import Console
+
+console = Console()
+
+# 导入所有应用命令
+try:
+    from .llm import app as llm_app
+except ImportError as e:
+    console.print(f"[yellow]警告: 无法导入 llm 命令: {e}[/yellow]")
+    llm_app = None
+
+try:
+    from .chat import app as chat_app
+except ImportError as e:
+    console.print(f"[yellow]警告: 无法导入 chat 命令: {e}[/yellow]")
+    chat_app = None
+
+try:
+    from .embedding import app as embedding_app
+except ImportError as e:
+    console.print(f"[yellow]警告: 无法导入 embedding 命令: {e}[/yellow]")
+    embedding_app = None
+
+try:
+    from .pipeline import app as pipeline_app
+except ImportError as e:
+    console.print(f"[yellow]警告: 无法导入 pipeline 命令: {e}[/yellow]")
+    pipeline_app = None
+
+try:
+    from .inference import app as inference_app
+except ImportError as e:
+    console.print(f"[yellow]警告: 无法导入 inference 命令: {e}[/yellow]")
+    inference_app = None
+
+try:
+    from .gateway import app as gateway_app
+except ImportError as e:
+    console.print(f"[yellow]警告: 无法导入 gateway 命令: {e}[/yellow]")
+    gateway_app = None
+
+# Note: studio and edge are now independent packages/repositories
+# - sage-studio: https://github.com/intellistream/sage-studio
+# - sage-edge: Install with: pip install isage-edge
+
+# 导出所有命令
+__all__ = [
+    "llm_app",
+    "chat_app",
+    "embedding_app",
+    "pipeline_app",
+    "inference_app",
+    "gateway_app",
+]