isage-cli 0.2.4.14__tar.gz

isage_cli-0.2.4.14/MANIFEST.in

@@ -0,0 +1,7 @@
+# Include compiled files and binary extensions
+recursive-include src *.pyc
+recursive-include src *.pyo
+recursive-include src __pycache__/*
+recursive-include src *.so
+recursive-include src *.pyd
+recursive-include src *.dylib

isage_cli-0.2.4.14/PKG-INFO

@@ -0,0 +1,295 @@
+Metadata-Version: 2.4
+Name: isage-cli
+Version: 0.2.4.14
+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.11.*
+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.14/README.md

@@ -0,0 +1,261 @@
+# 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.14/pyproject.toml

@@ -0,0 +1,93 @@
+[project]
+name = "isage-cli"
+dynamic = ["version"]
+description = "SAGE Command Line Interface - Unified CLI for SAGE platform"
+readme = "README.md"
+requires-python = "==3.11.*"
+license = { text = "MIT" }
+authors = [{ name = "IntelliStream Team", email = "shuhao_zhang@hust.edu.cn" }]
+keywords = ["sage", "cli", "command-line", "streaming", "ai"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+dependencies = [
+    "typer>=0.15.0,<1.0.0",
+    "rich>=13.0.0",
+    "pyyaml>=6.0",
+    "python-dotenv>=1.1.0,<2.0.0",
+    "requests>=2.32.0,<3.0.0",
+    "httpx>=0.28.0,<1.0.0",
+    "colorama>=0.4.6",
+    "tabulate>=0.9.0,<1.0.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.4.0", "pytest-cov>=4.0.0", "ruff==0.14.6", "isage-pypi-publisher>=0.2.0"]
+[project.scripts]
+sage = "sage.cli.main:app"
+
+[project.urls]
+Homepage = "https://github.com/intellistream/SAGE"
+Documentation = "https://intellistream.github.io/SAGE"
+Repository = "https://github.com/intellistream/SAGE"
+Issues = "https://github.com/intellistream/SAGE/issues"
+
+[build-system]
+requires = ["setuptools>=65.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+namespaces = true
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = { attr = "sage.cli._version.__version__" }
+
+[tool.black]
+line-length = 100
+target-version = ['py39', 'py310', 'py311', 'py312']
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+# ============================================================================
+# Code Quality Configuration
+# Extends from root ruff.toml for unified standards across all packages
+# ============================================================================
+[tool.ruff]
+extend = "../../tools/ruff.toml"
+
+[tool.pytest.ini_options]
+testpaths = ["tests", "src"]
+python_files = ["test_*.py", "*_test.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--benchmark-storage=../../.sage/benchmarks",
+    "-o",
+    "cache_dir=../../.sage/cache/pytest",
+    "--strict-markers",
+    "--strict-config",
+    "--verbose",
+    "-ra",
+]
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+    "integration: marks tests as integration tests",
+    "unit: marks tests as unit tests",
+    "cli: marks tests as CLI tests",
+]
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.package-data]
+"*" = ["*.pyc", "*.pyo", "__pycache__/*", "*.so", "*.pyd", "*.dylib"]

isage_cli-0.2.4.14/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

isage_cli-0.2.4.14/setup.py

@@ -0,0 +1,9 @@
+
+from setuptools import setup
+
+setup(
+    include_package_data=True,
+    package_data={
+        "": ["*.pyc", "*.pyo", "__pycache__/*", "*.so", "*.pyd", "*.dylib"],
+    },
+)